Setting up CyberArk integration¶

Rotating credentials that provide machines privileged access is a critical piece of maintaining robust security in your datacenter. The TLS Protect Cloud integration with CyberArk allows TLS Protect Cloud to access credentials stored in a CyberArk vault when performing functions like provisioning certificates to machines.

This allows you to take advantage of TLS Protect Cloud's certificate monitoring and provisioning services while continuing to manage your credentials in CyberArk.

Overview¶

TLS Protect Cloud uses the CyberArk Central Credential Provider service to access credentials stored in CyberArk. Once the connection between CyberArk and TLS Protect Cloud is established, you can create credential references from TLS Protect Cloud to credentials stored in CyberArk.

Credential references can then be assigned to a machine in TLS Protect Cloud. When you want to provision a certificate to that machine, TLS Protect Cloud uses the CyberArk credential to access the machine.

Since TLS Protect Cloud creates a reference to the CyberArk credential, any update to the credential in CyberArk will be automatically used by TLS Protect Cloud when provisioning a certificate to a machine.

VSatellite¶

The connection between TLS Protect Cloud and your CyberArk service is established through a Venafi VSatellite. VSatellite is a small piece of software installed on a Linux server in your data center that can access both TLS Protect Cloud and your CyberArk service, thereby becoming the bridge between the two services.

Step 1: Deploy VSatellites in your datacenter¶

If you don't already have any VSatellites installed, you'll need to get those up and running first. VSatellite is the connector between TLS Protect Cloud and CyberArk.

The VSatellites need to be able to access CyberArk in your datacenter. Before proceeding with the next step, make sure to have the IP addresses of the VSatellites readily available.

Follow our documentation to deploy VSatellites.

Step 2: Set up the CyberArk connection in TLS Protect Cloud¶

With VSatellites now in place, you're ready to create an application in CyberArk and then connect TLS Protect Cloud to that application.

Performed by: System Administrator

1. Sign in to TLS Protect Cloud.
2. Click Inventory > Credentials.

3. Under CyberArk Configuration, complete the fields according to the following guidelines:

   Field	Description
   Central Credentials Provider Web Services URL	The URL to the CyberArk Central Credential Provider service.
   Application Name	The name of the application in CyberArk that this connector is allowed to connect to.
   Certificate Credential	(Optional) The certificate credential required to authenticate to the CyberArk service. After you upload the certificate, you'll be prompted to enter the certificate password.
   Choose a VSatellite	The list of VSatellites that are allowed to connect to CyberArk. These VSatellites must be whitelisted on the CyberArk application.

4. Click Test Access.

   If your access is unsuccessful, check the troubleshooting tips below.

5. Click Save.

Step 3: Import credentials from CyberArk¶

With the connector now in place, you can import credentials into TLS Protect Cloud. CyberArk credentials in TLS Protect Cloud are just references to the real credentials stored in CyberArk.

Performed by: System Administrator

1. In TLS Protect Cloud, click Settings > Credentials.

2. Click New > CyberArk Credential. Complete the fields on the Add a new credential screen according to the following guidelines.

   Field	Description
   Name	The name for this credential to be displayed in TLS Protect Cloud.
   Owning Teams	One or more TLS Protect Cloud teams that have permission to use this credential. These same teams should be assigned to the machine you'll create in Step 4.
   CyberArk Access Type	The type of credential that TLS Protect Cloud will receive from CyberArk. The type you select determines if TLS Protect Cloud will reference only the password, or both the username and password from an account in CyberArk.
   Account Name	The name of the Account in CyberArk that contains the credential you want to import.
   Safe	The CyberArk safe.
   Folder	(Optional) The folder in CyberArk where the credential is located.

3. Click Save. The Credentials page opens with your new credential listed.

4. You can now test the credential you just created. Click the vertical ellipses icon on the row of the new credential, and select Test Access.

   If TLS Protect Cloud was unable to access the credential, see the troubleshooting tips below.

Step 4: Assign the CyberArk credential on a TLS Protect Cloud machine¶

Performed by: Resource Owner or higher

Now that the credential is in TLS Protect Cloud, you can assign it to a machine, as long as the Owning Team assigned to the machine matches the Owning Team assigned to the credential.

Troubleshooting¶

Use these tips to troubleshoot common errors.

CyberArk connector access errors¶

CyberArk credential access errors¶