This guide provides the details about Britive application and CyberArk Identity provisioning integration.

Requirements

Ensure that you have the following before integrating Britive and CyberArk Identity:

SCIM 2.0 Base URL
Bearer token

Configuration Steps

Configuring an Identity Provider on Britive

An identity provider needs to be created in Britive for SSO.

Log in to the Britive application with administrator privileges.
Click on Admin->Identity Management from the navigation menu.
Click on the Identity Providers tab.
Click on the Add Identity Provider button.
Enter name and description.
Select Identity Provider Type as SAML.
Click Add. A configuration page is displayed.

Configuring Provisioning on Britive

Copy the SCIM URL and note it down. This URL is entered later to configure on the identity provider portal.
Click on the Edit button under Additional Settings in the SCIM tab.
1. Select the Allow tag name and description to be editable option to allow editing of tags for externally managed tags.
Click on the Edit icon under SCIM Provider in the SCIM tab.
1. Select Generic from the drop-down list for configuring an identity provider.
2. Save the changes by clicking the icon next to the selection.
3. Click on Create Token.
4. Enter the validity of the token and create a token. Copy this generated token and note it down. Click OK. This token is not displayed again. This token is entered later on the identity provider portal.
5. Click on the Recreate token button to generate a new token, if needed.
6. Click on Edit token validity to update the validity.
Map the incoming attributes using the procedure explained in User mapping.

User mapping

After provisioning, by default, seven attributes from the identity provider are mapped to a Britive user.

You can see the mapped attributes by checking the Mapped Attributes checkbox in the User Mapping section. Out of these attributes, Status, Email, First Name, Last Name, and Username are mandatory attributes. The identity provider must send these attributes for the user to be created in Britive.

Additional user attributes from the identity provider can be configured in Britive. Follow these steps to map additional attributes:

Select Admin->Identity Management from the navigation menu.
Click on the Identity Attributes tab.
Create a new attribute by clicking the Add Identity Attribute button.
Enter the following values on the Add Identity Attribute page:
1. Enter the name and description of the attribute.
2. Select the type of attribute from the drop-down list.
3. Check Multi valued field for attributes that can have multiple values. For example, user roles.
4. Click Add. The created attribute is displayed in the list of identity attributes.
Click the Identity Providers tab.
Select the identity provider and click on the SCIM tab.
Uncheck the Mapped Attributes checkbox to see the list of unmapped attributes.
Click Edit.
Map the identity attribute with the incoming SCIM attribute.
To add custom attributes, please select the identity attribute and type the name of the custom attribute as defined in the IDP.
Click Save.

Configuring CyberArk Identity for Provisioning

Login to CyberArk User Portal as CyberArk identity Administrator.
Navigate to the Admin Portal.
Navigate to Apps & Widgets -> Web Apps from the sidebar menu and click the Add Web Apps button.
Click on the Custom tab and add the SAML web app.
Enter the following on the Settings page:
1. Add a Name and Description.
2. Uncheck the Show in user app list checkbox from the Advanced section.
Copy the SCIM URL and token from Britive.
Enter the following on the Provisioning page:
1. Check Enable Provisioning for this application.
2. Add the SCIM URL copied from Britive in the SCIM Service URL.
3. Select Authentication Type as Authorization Header.
4. Select Header Type as Bearer Token and add token in Bearer Token.
5. Click on Verify to validate the credentials.
Add specific roles required to be provisioned as groups under role mapping.
Click Save to save the web application.