Skip to main content

CyberArk Idaptive

Visualize CyberArk Idaptive Devices, Users, Applications, Roles, Accounts and monitor changes through queries and alerts.

This integration ingests devices, users, accounts, applications, and roles from the CyberArk Idaptive REST API. Setup involves two parts: creating a service account and an OAuth2 client application in your CyberArk Idaptive tenant, then configuring the integration in JupiterOne using the credentials you generate.

Installation​

To complete setup you need:

  • A CyberArk Idaptive tenant (e.g., https://my-tenant.id.cyberark.cloud). You log in with a tenant admin account to create the service user and the OAuth2 application.
  • The CyberArk Idaptive Identity APIs reference.

Step 1: Create a service account​

  1. Log in to your CyberArk Idaptive tenant and navigate to the Admin portal.

    Admin Portal

  2. Go to Core Services > Users. Fill in all required fields. Check Password never expires, Is service user, and Is OAuth Credential Client in the status section, then click Create user.

    Create User

Step 2: Create an OAuth2 client application​

  1. In the Admin portal, click Apps & Widgets > Web Apps, then click Add Web Apps.

    Web Apps page

  2. Select Custom and choose OAuth2 Client from the list.

    Select client web app

  3. Select the Organization from the dropdown and click Add.

    Select organization

  4. On the Settings page, enter an ID for the application. Save this ID — you will need it as the CyberArk Idaptive Client Application Id when configuring the JupiterOne integration.

    Application page

  5. Click General Usage in the sidebar. Select Confidential and check Must be OAuth Client.

    OAuth client

  6. Go to Tokens in the sidebar, select Client credentials, and set a token validity period greater than 10 minutes. Enable refresh tokens.

    Client credentials

  7. Go to Scope in the sidebar and click Add. Name the scope all and set the regex to:

    CDirectoryService/GetUsers|redrock/query|Roles/GetRoleMembers|SysInfo/About|UPRest/GetResultantAppsForUser|Acl/GetRowAces

    Scopes

  8. Go to Permissions in the sidebar, search for the service account you created in step 2, and click Add. Grant the Run permission to the service account, then click Save.

    Add service account

Step 3: Grant the System Administrator role​

  1. In the Admin portal, navigate to Roles > System Administrator.

    Admin role

  2. Go to Members and add the service account as a member.

    Assign role

Configuration in JupiterOne​

To install the CyberArk Idaptive integration in JupiterOne, navigate to the Integrations tab in JupiterOne and select CyberArk Idaptive. Click New Instance to begin configuring your integration.

Creating an instance requires the following:

  • The Account Name used to identify the CyberArk Idaptive account in JupiterOne. Ingested entities will have this value stored in tag.AccountName when the AccountName toggle is enabled.

  • Description to assist in identifying the integration instance, if desired.

  • Polling Interval that you feel is sufficient for your monitoring needs. You may leave this as DISABLED and manually execute the integration.

  • CyberArk Idaptive instance URL — The URL of your CyberArk Idaptive tenant, for example https://my-tenant.id.cyberark.cloud.

  • CyberArk Idaptive Client Application Id — The application ID you assigned when creating the OAuth2 client app (step 6 above).

  • CyberArk Idaptive Service Account Username — The username of the service account you created in step 2.

  • CyberArk Idaptive Service Account Password — The password for the service account.

Click Create once all values are provided to finalize the integration.

Next steps​

Now that your integration instance has been configured, it will begin running on the polling interval you provided, populating data within JupiterOne. Continue on to our Instance management guide to learn more about working with and editing integration instances.