Sync users between two environments
Learn how to set up a SCIM connection from one PingOne environment to another. You’ll use the SCIM protocol to synchronize users between the two environments.
Create two environments and a Worker app
Create two environments that PingOne will synchronize, and a Worker application that will handle the synchronization.
Steps
-
Create the following two environments in PingOne:
-
P1-User-Source
-
P1-User-Destination
Learn more in Adding an environment.
-
-
Go to the P1-User-Destination environment.
-
Go to Applications → Applications and create a new Worker Application with the following configuration:
-
Grant type: Client Credentials
-
Token Endpoint Authentication Method: Client Secret Basic
Learn more in Adding an application.
-
-
Use the toggle to enable the new Worker application.
-
In the application details panel, click the Rolestab and add the Identity Data Admin role to your worker app
Learn more in Configuring roles for a worker application.
-
In the application details panel, click the Configuration tab. Copy the following values to a secure location to use when making a provisioning connection:
-
Token Endpoint
-
Client ID
-
Client Secret
-
Environment ID
-
Create users and a group
Create several users to be provisioned, and a group to identify them.
Steps
-
Go to the P1-User-Source environment.
-
Go to Directory → Users.
-
Create several users for provisioning.
-
Populate the following attributes for each user:
-
Email Address
-
Given Name
-
Family Name
-
-
Go to Directory → Groups.
-
Create a group called Provisioning Users and add any two users to that group.
For more information, see Managing group membership.
Create a provisioning connection
Create a provisioning connection to define the source and target for provisioning.
Before you begin
Locate the values that you copied in Create two environments and a Worker app.
Steps
-
Go to the P1-User-Source environment.
-
Go to Integrations → Provisioning.
-
Click the button and then click New Connection.
-
For connection type, select Identity Store.
-
Locate the SCIM tile and then click Select.
-
Click Next.
-
Enter a name and description. Click Next.
-
On the Authentication step, enter the following values:
-
SCIM Base URL: https://scim-api.pingone.<region>/environments/<envID>/v2
Replace <region> with the appropriate value for your geographic region, such as .com, .ca, or .eu. For more information, see IP address and domain reference. Replace <envID> with the value you copied when you created the Worker app.
-
Users Resource: /Users
-
SCIM Version: 2.0
-
Groups Resource: /Groups
-
Authentication Method: OAuth 2 Client Credentials
-
OAuth Token Request: Paste the Token Endpoint value that you copied from Create two environments and a Worker app.
-
OAuth Client ID: Paste the Client ID value that you copied from Create two environments and a Worker app.
-
OAuth Client Secret: Paste the Client Secret value that you copied from Create two environments and a Worker app.
-
Auth Type Header: Select OAuth Client Credentials
-
-
Click Test connection to verify that PingOne can establish a connection to the SCIM resource.
Result:
If there are any issues with the connection, a Test Connection Failed dialog box opens. Click Continue to resume the setup with an invalid connection.
You cannot use the connection for provisioning until you have established a valid connection to SCIM. To retry, click Cancel in the Test Connection Faileddialog box and repeat step 8.
Troubleshooting:
Learn more about troubleshooting your connection in Troubleshooting Test Connections Failure.
-
On the Configure preferences page, enter the user filter and the action to take when deprovisioning users.
The filtering parameters are optional.
Option Description User filter expression
Determines how the connection uses the specified User Identifier to match existing users in the target identity store to the users being provisioned from the source identity store. Learn more in SCIM filter expressions.
User identifier
The identifier for the user filter expression.
Custom Attribute Schema URNs (optional)
A comma-delimited list of schema URNs to define a location for custom attributes. Use this option if the SCIM provider does not follow the standard naming convention for schema extensions in which custom attributes are defined. That is, URNs of the form
urn:ietf:params:scim:schemas:extension:<Organization Name>:2.0:User
.Allow users to be created
Determines whether to create a user in the target identity store when the user is created in the source identity store.
Allow users to be updated
Determines whether to update user attributes in the target identity store when the user is updated in the source identity store.
Allow users to be disabled
Determines whether to disable a user in the target identity store when the user is disabled in the source identity store.
Allow users to be deprovisioned
Determines whether to deprovision a user in the target identity store when the user is deprovisioned in the source identity store.
Remove action
The action to take when removing a user from the target identity store.
Deprovision on rule deletion
Determines whether to deprovision users if the associated provisioning rule is deleted.
-
Click Save.
-
Use the toggle to enable the new connection.
You cannot enable the new connection until you add the Identity Data Admin role to your worker app. Learn more in Configuring roles for a worker application.
Create a provisioning rule
Create a provisioning rule to identify which identities will be provisioned.
Steps
-
Go to the P1-User-Source environment.
-
Go to Integrations → Provisioning.
-
Click the button and then click New Rule.
-
Enter a name for the rule.
-
On the Configuration tab, click the Target button, then select the SCIM connection you created in Create a provisioning connection.
-
Click Save.
-
On the Configuration tab, click the User Filter button, then click the pencil icon.
-
Set the filter to Group Names- Contains- Provisioning Users.
-
Click Save.
-
On the Configuration tab, click the Attribute Mapping button.
-
Verify the default attribute mappings.
-
On the rule overview page, use the toggle to enable the rule, which will initiate the provisioning process.
Verify the sync operation
After you have set up a connection and a rule, you can use the Sync summary and the Audit page to confirm that the sync is working.
Steps
-
Do one of the following:
-
To use the Sync summary, click the rule entry to open the rule details panel.
-
To use the Audit page, go to Monitoring → Audit.
For more information, see Viewing sync status.
-
Result
In the P1-User-Source environment, any users in the Provisioning Users group will be provisioned to the P1-User-Destination environment. You can add or remove users from the group to see the changes synchronized between the two PingOne environments.
Next steps
You can add or remove users from the group to see the changes synchronized between the two PingOne environments.