How to Create and Configure CyberArk Account for the Integration

To successfully integrate UCMDB/UD with CyberArk, follow the instructions below strictly to create and configure a safe, an account, and an application ID in CyberArk for the integration.

1. Sign in to CyberArk Password Vault

   1. In your Web browser, enter http://<IP address of CyberArk Password Vault Web Access machine>/PasswordVault.

   2. Select CyberArk as the authentication method.

      

   3. Provide your user name and password, and click Sign in.

2. Create and configure a Safe

   To do so,

   1. Go to the POLICIES tab and create a safe

      1. On the POLICIES tab, from the navigation pane select Access Control (Safes), and then click Add Safe .

      2. On the Add Safe page, provide values as described below:

         • Safe name: Provide a Safe name. For example, NancySafe.
         • Description: Provide a description for the Safe name.
         • Saved Passwords: Keep the default Save password versions from the last [7] days option selected.
         • Assigned to CPM: Keep the default PasswordManager option selected.

         

      3. Click Save

   2. Add the new Safe to the Safe Members list

      1. On the Safe Details: <Safe Name> page, click Add Member.

         

      2. In the Add Safe Member dialog, click Search, and then from the returned list select the desired Credential Provider Username (usually Prov_<server>).

         

         Note The credential provider user only needs the following permissions:

         • Retrieve accounts
         • List accounts
         • View Safe Members
      3. Click Add.

      4. Click Close.

         The Credential provider username you just added should now display in the Members list.

3. Create and configure an account

   1. Go to the ACCOUNTS tab, click Add Account .

   2. On the Add Account page, provide values as described below:

      • Store in Safe: Select the Safe name you just created in step 2.

      • Device Type: Select Operating System from the drop-down list.

        Note: The required properties and optional properties may vary with the device type you select. In this document, Operating System and Windows Domain Account are selected for Device Type and Platform Name respectively as an example. For details about other properties, refer to the CyberArk Credential Provider and ASCP Implementation Guide .
      • Platform Name: Select a platform name value from the drop-down list. In this example, Windows Domain Account is selected.

      • Address: (Optional) Enter the IP address of the target server that you want to discover.

      • User Name: Specify the user name for the account you configure in CyberArk. This is the account used by the UCMDB Server to connect to the target server that you want to discover.

      • Password: Enter the password for the account you configure in CyberArk.
      • Confirm Password: Enter your password again.

      • Name: Select an Auto-generated or Custom name for your Safe account.

        If you select Custom, provide a custom account name. For example, nancy-cyberark-testing-refid.

      For example,

      

   3. Click Save.

4. Create and configure an application ID

   1. Go to the APPLICATIONS tab and create an application ID.

      1. On the APPLICATIONS tab, click .

      2. In the Add Application dialog, provide values as described below:

         • Name: Specify UniversalDiscovery as the application ID for UCMDB.
         • Description: Provide a description for the application ID.
         • Location: Select \Applications.
         • Other fields: Provide values as necessary.

         

      3. Click Add.

   2. Add the new application ID to the Safe members list.

      1. Go to the POLICIES tab, from the navigation pane select Access Control (Safes), and then select NancySafe from the Safe Name list.
      2. Click Members in the lower right corner of the page.
      3. On the Safe Details: NancySafe page, click Add Member.
      4. In the Add Safe Member dialog, select UniversalDiscovery.
      5. Click Add.

   3. Add the full name of the Credential Provider Servers to the Allowed Machines list.

      1. Go to the APPLICATIONS tab, select UniversalDiscovery.
      2. On the Application Details: UniversalDiscovery page, go to the Allowed Machines tab.
      3. Click Add Machine .
      4. In the Add allowed machine dialog, enter IP, host name, or DNS.
      5. Click Add.

   4. Add path authentication for UniversalDiscovery.

      1. Go to the Authentication tab, click Add authentication details , and then select Path.

      2. In the Add Path Authentication dialog,

         • In the Path field, enter the path, for example, C:\UCMDB\DataFlowProbe.

         • Make sure you select the check box for both of the following options:

           • Path is folder
           • Allow internal scripts to request credential on behalf of this application ID.

         For example,

         

      3. Click Add.

   5. Add operating system user authentication for the new application ID.

      1. On the Authentication tab, click Add authentication details , and then select OS user.

      2. In the Add Operating System User Authentication dialog, provide OS user information, for example, NT AUTHORITY\SYSTEM.

         

         Note  

         • If the Probe is running as a service, specify NT AUTHORITY\SYSTEM as OS user.

         • If the Probe is running as console, specify <hostname\username> as OS User. For example, HPSWVM0999\Administrator.
      3. Click Add.