You can view or modify an existing connection based on the SCIM Connector with Active Roles . Modifying a SCIM Connector is typically required if any change occurs in the SCIM-based Starling Connect connectors to which the Active Roles connection was originally configured.
To view or modify an existing SCIM Connector connection
-
In the , open the Connections tab.
-
Click Connection settings below the existing SCIM connection you want to modify.
-
On the Connection Settings tab, click the Specify connection settings item to expand it and update the required settings.
For more information on the available settings, see Creating a SCIM connection with the SCIM Connector.
-
To apply your changes, click Save.
With the Generic SCIM Connector, you can configure inbound data synchronization connections for the following SCIM 2.0-based One Identity Starling Connect connectors:
NOTE: Consider the following when planning to configure a SCIM-based data synchronization connector:
-
While the Generic SCIM Connector may work with other SCIM 2.0-based Starling Connect connectors whose attribute query semantics are compatible on a network level with the SuccessFactors HR 8.0 and ServiceNow 2.0 connectors, One Identity tested it to work only with these two connectors.
-
To configure a connection to the PingOne or Workday HR connectors of Starling Connect, use the SCIM Connector of Active Roles . For more information, see Configuring data synchronization with the SCIM Connector.
For the list of Active Roles Active Roles connector features that the Generic SCIM Connector supports or does not support, see the following table.
Table 106: Generic SCIM Connector – Supported features
|
Bidirectional synchronization
Specifies whether you can both read and write data in the connected data system. |
No |
|
Delta processing mode
Specifies whether the connection can process only the data that has changed in the connected data system since the last synchronization operation. This reduces the overall synchronization duration. |
No |
|
Password synchronization
Specifies whether you can synchronize user passwords from an Active Directory (AD) domain to the connected data system. |
No |
|
Secure Sockets Layer (SSL) data encryption
Specifies whether the connector can use SSL to encrypt data transmitted between Active Roles and the connected data system. |
Yes |
For more information on the SCIM protocol, see the official SCIM site, or the following IETF RFC documents:
-
IETF RFC-7642: System for Cross-domain Identity Management: Definitions, Overview, Concepts, and Requirements
-
IETF RFC-7643: System for Cross-domain Identity Management: Core Schema
-
IETF RFC-7644: System for Cross-domain Identity Management: Protocol
You can configure an Active Roles connection to the SuccessFactors HR 8.0 and ServiceNow 2.0 connectors of Starling Connect with the Generic SCIM Connector.
Prerequisites
Before configuring the connection, make sure that the following conditions are met:
-
Your organization must have an active Starling Connect account.
-
The Starling connector to which you want to connect (SuccessFactors HR 8.0 or ServiceNow 2.0) must be already configured in Starling Connect.
-
If your organization is using a proxy server for outbound connections, make sure that the system level proxy settings are properly configured.
To configure system-level proxy settings, navigate to one of the following Windows configuration pages:
To configure a connection to a Starling Connect connector with the Generic SCIM Connector
-
In Active Roles , navigate to Connections > Add Connection.
Figure 4: Active Roles – Adding a new connection via Connections > Add connection
-
In the Name connection and select connector step, specify a custom Connection name. Then, to load the SCIM-specific connector settings, from the Use the specified connector drop-down list, select Generic: SCIM Connector and click Next.
Figure 5: Add Connection – Specifying the connection name and connector type
The Connection settings step of the Generic SCIM Connector appears.
Figure 6: Generic SCIM Connector – General, authentication and implementation settings
-
Under General settings, specify the base SCIM URL of the Starling Connect connector to which you want to connect.
TIP: To check the base SCIM URL of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, select the SCIM-based connector to which you want to connect (SuccessFactors HR or ServiceNow), then copy the value of the SCIM URL property.
-
Under Authentication settings, to enable the authentication scheme options required by the supported Starling Connect connectors, select the Starling authentication scheme, then configure the following settings:
-
Token endpoint URL: Specifies the full path of the Starling connector token endpoint.
TIP: To find the token endpoint URL of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the SCIM Token Endpoint URL property.
-
Client ID: Specifies the SCIM client ID.
TIP: To find the SCIM client ID of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the SCIM Client ID property.
-
Client secret: Specifies the SCIM client secret.
TIP: To find the SCIM client secret of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the Show SCIM Client Secret text box.
-
Under Implementation plugin, to enable the pre-made connection implementation for the supported Starling Connect connectors, select Starling batch 1 - v1.0.
NOTE: While the Generic SCIM Connector may work with other SCIM 2.0-based Starling Connect connectors whose attribute query semantics are compatible on a network level with the SuccessFactors HR 8.0 and ServiceNow 2.0 connectors, One Identity tested it to work only with these two connectors.
For the list of SCIM attributes supported by Starling Connect for these connectors, see the SuccessFactors and ServiceNow chapters of the Starling Connect Active Roles Administration Guide.
-
(Optional) Configure the following Starling Connect connection settings:
-
Import uses direct query: When selected, Active Roles queries every synchronized object separately by their ID. One Identity recommends selecting this setting when configuring a connection to the Starling Connect ServiceNow 2.0 connector, or similar connectors.
NOTE: Enabling this setting decreases synchronization speed considerably, but it is required to read all object attributes for Starling Connect ServiceNow 2.0 (or similar) connectors.
However, do not enable this setting when configuring the Generic SCIM Connector for the Starling Connect SuccessFactors HR connector, as it has no effect on the results of import data synchronization.
-
Max degree of parallelism: If Import uses direct query is enabled, this setting specifies the maximum number of threads that Active Roles can run in parallel for the direct query of each object in the response list (that is, how many entries can Active Roles query simultaneously).
TIP: One Identity recommends testing the value optimal for your environment, and setting it as low as possible. Specifying a value of 1 means no parallelism is configured.
NOTE: Consider the following when using this setting:
-
This setting works only if Import uses direct query is enabled. Active Roles will ignore any value specified for Max degree of parallelism if Import uses direct query is not selected.
-
Setting the value of Max degree of parallelism too high may result in connector service instability.
-
Check the implementation plugin information indicated on the screen. Make sure that the Supported Features, the Target Service Providers and the supported Starling Connect connector versions will meet the requirements of your planned mapping rule and/or sync workflow.
-
To verify that the specified authentication settings are correct, click Test Connection.
NOTE: Clicking Test Connection verifies only if the authentication settings for the SCIM metadata endpoint connection are correct, and if Active Roles can fetch the SCIM schemas and query the resourceTypes metadata from the configured SCIM service.
When testing the connection, Active Roles does not query any actual resource objects. Because of this, testing may finish successfully even if the connection is down between Starling Connect and the third-party service provider (for example, SuccessFactors HR), preventing the import of actual data during synchronization later.
TIP: If testing fails, Active Roles will highlight the settings that it detects as incorrect. Check and fix those settings, then try again. If testing fails again, then:
-
Check your network connectivity.
-
Check if the Starling Connect service is available.
-
Make sure that the Starling Connect connector you specified during configuration is still active and working.
-
If you use a proxy server, make sure that the system-level proxy settings are properly configured.
-
If testing completed successfully, create the new SCIM connection to the Starling Connect connector by clicking Finish.
Once Active Roles creates the connection, you can use it to configure SCIM-based data synchronization by setting up one or more mapping rules and sync workflows.
You can view or modify an existing connection based on the Generic SCIM Connector with Active Roles . Modifying a Generic SCIM Connector connection is typically required if any change occurs in the SCIM-based Starling Connect connectors to which the Active Roles connection was originally configured.
To view or modify an existing Generic SCIM Connector connection
-
In Active Roles , click Connections.
-
In the Connections page, search for the connection that uses the Generic SCIM Connector, and click Connection settings.
-
(Optional) In the General step, modify the custom Connection name.
-
(Optional) In the Connection Settings step, modify the following settings as you need:
-
Token endpoint URL: Specifies the full path of the Starling connector token endpoint.
TIP: To find the token endpoint URL of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the SCIM Token Endpoint URL property.
-
Client ID: Specifies the SCIM client ID.
TIP: To find the SCIM client ID of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the SCIM Client ID property.
-
Client secret: Specifies the SCIM client secret.
TIP: To find the SCIM client secret of the Starling Connect connector, in Starling Connect, navigate to Connectors > Active Connectors, and copy the value of the Show SCIM Client Secret text box.
-
Import uses direct query: When selected, Active Roles queries every synchronized object separately by their ID. One Identity recommends selecting this setting when configuring a connection to the Starling Connect ServiceNow 2.0 connector, or similar connectors.
NOTE: Enabling this setting decreases synchronization speed considerably, but it is required to read all object attributes for Starling Connect ServiceNow 2.0 (or similar) connectors.
However, do not enable this setting when configuring the Generic SCIM Connector for the Starling Connect SuccessFactors HR connector, as it has no effect on the results of import data synchronization.
-
Max degree of parallelism: If Import uses direct query is enabled, this setting specifies the maximum number of threads that Active Roles can run in parallel for the direct query of each object in the response list (that is, how many entries can Active Roles query simultaneously).
TIP: One Identity recommends testing the value optimal for your environment, and setting it as low as possible. Specifying a value of 1 means no parallelism is configured.
NOTE: Consider the following when using this setting:
-
This setting works only if Import uses direct query is enabled. Active Roles will ignore any value specified for Max degree of parallelism if Import uses direct query is not selected.
-
Setting the value of Max degree of parallelism too high may result in connector service instability.
-
(Optional) In the Scope step, modify the scope of objects included in the data synchronization process of the connection. For more information on the Scope settings, see Modifying synchronization scope for a connection.
-
(Optional) In the Connection Handlers step, create, update or remove any automated data synchronization operations for the connection. For more information on the Connection Handlers settings, see Using connection handlers.
-
To apply your changes, click Save and Continue.
