Who can use this feature?
Workspace Owners, Super Admins, and Admins
Only supported using the Cerby web app
Cerby uses unique SCIM gateway tokens for secure identity provider (IdP) integration with each application connected through our Identity Lifecycle Management (IdLCM) solution. These tokens are used to authenticate and authorize API requests between a SCIM client and a SCIM server, enabling your identity provider (IdP) to provision users to your Cerby-integrated apps.
When you set up an app integration in your IdP to connect it to your Ceby-integrated app, you must provide the SCIM gateway URL, a SCIM gateway token, and the Bookmark URL. You can retrieve these elements in the following ways:
The following sections describe each way.
Retrieve the SCIM gateway URL
To retrieve the SCIM gateway URL of an IdLCM integration, you must complete the following steps:
Log in to your Cerby workspace.
Select the Integrations option from the left menu. The Integrations page is displayed.
Select the integration you want to connect to your IdP. The integration details page is displayed with the Settings tab activated.
Activate the Connected services left tab.
Click the Copy icon (
) in the SCIM Gateway URL field.
Now you are done. You can paste the SCIM gateway URL when required by your IdP.
Generate a SCIM gateway token
To generate the SCIM gateway token for the first time for a new IdLCM integration, you must complete the following steps:
Log in to your Cerby workspace.
Select the Integrations option from the left menu. The Integrations page is displayed.
Select the integration you want to connect to your IdP. The integration details page is displayed with the Settings tab activated.
Activate the Connected services left tab.
Click the Generate token button in the SCIM Gateway section. The Generate token dialog box is displayed, as shown in Figure 1.
Figure 1. Generate token dialog box
Click the Copy icon (
) to copy the authentication token to the clipboard.
TIP: Keep the Generate token dialog box open as the generated token is only displayed once. If you lose the token, you must generate a new one.
Now you are done. You can paste the SCIM gateway token when required by your IdP.
Regenerate a SCIM gateway token
To regenerate the SCIM gateway token of your IdLCM integration when you need to replace an existing token, you must complete the following steps:
Log in to your Cerby workspace.
Select the Integrations option from the left menu. The Integrations page is displayed.
Select the integration you want to connect to your IdP. The integration details page is displayed with the Settings tab activated.
Activate the Connected services left tab.
Click the More options (
) icon in the SCIM Gateway section. A drop-down menu is displayed.
Select the Generate new token option from the menu. The New token dialog box is displayed.
Click the Generate new token button. The Generate token dialog box is displayed.
Click the Copy icon (
) to copy the authentication token to the clipboard.
TIP: Keep the Generate token dialog box open as the generated token is only displayed once. If you lose the token, you must regenerate a new one.
Now you are done. You can paste the SCIM gateway token when required by your IdP.
Retrieve the Bookmark URL
To retrieve the Bookmark URL of an IdLCM integration, you must complete the following steps:
Log in to your Cerby workspace.
Select the Integrations option from the left menu. The Integrations page is displayed.
Select the integration you want to connect to your IdP. The integration details page is displayed with the Settings tab activated.
Activate the Connected services left tab.
Click the Copy icon (
) in the Bookmark URL field located in the Quick access shortcut section.