The Microsoft Azure AD Connector of the Active Roles supports the following Azure Active Directory (Azure AD) group attributes for data synchronization.
NOTE: When configuring a data synchronization mapping rule with the Microsoft Azure AD Connector, consider that the following group attributes are currently not supported and cannot be queried via the Microsoft Graph API:
This means that although these group attributes are visible, they cannot be set in a mapping rule.
Table 114: Azure AD group attributes supported for data synchronization
description |
Gets or sets the group description. |
Read, Write |
dirSyncEnabled |
Gets whether the group was synchronized from the on-premises Active Directory Domain Services (AD DS). |
Read |
displayName |
Gets or sets the display name of the group.
NOTE: This attribute is required when creating a group. |
Read, Write |
lastDirSyncTime |
Gets the time when the group was last synchronized with the on-premises AD DS. |
Read |
mail |
Gets or sets the e-mail address of the group. |
Read, Write |
mailEnabled |
Gets or sets whether the group is mail-enabled.
NOTE: This attribute is required when creating a group. |
Read, Write |
mailNickName |
Gets or sets the mail alias of the group.
NOTE: This attribute is required when creating a group. |
Read, Write |
members |
Gets or sets the members of the group. |
Read, Write |
objectId |
Gets the unique identifier of the group. |
Read |
objectType |
Gets the object type of the group. |
Read |
provisioningErrors |
Gets the errors encountered when provisioning the group. |
Read |
proxyAddresses |
Gets the known address entries of the group. |
Read |
securityEnabled |
Gets or sets whether the group is a security group.
NOTE: This attribute is required when creating a group. |
Read, Write |
With the SCIM Connector, you can configure inbound data synchronization connections for the following SCIM-based One Identity Starling Connect connectors:
NOTE: Consider the following when planning to configure a connection with the SCIM Connector:
-
The SCIM Connector is tested to support the Starling Connect PingOne and Workday HR connectors. To configure a connection for import-based workflows to the SCIM 2.0-based SuccessFactors HR 8.0 or ServiceNow 2.0 Starling connectors, use the Generic SCIM Connector instead. For more information, see Configuring data synchronization with the Generic SCIM Connector.
-
The SCIM Connector supports only the standard schema of the SCIM protocol. It does not support extended schemas, and therefore cannot handle user-made custom attributes.
For the list of Active Roles connector features that the SCIM Connector supports or does not support, see the following table.
Table 115: 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
To create a new connection
- In the Synchronization Service Administration Console, open the Connections tab.
-
Click Add Connection, and then use the following options:
- Click Next.
-
On the Add Connection page, select the following options:
- SCIM settings
- SCIM version. Select the required version of the SCIM. The available options are V2 and V1.1.
- SCIM URL. Provide the SCIM URL.
- Schema URL. Provide the schema URL.
- Authentication type. Select the authentication type. The available options are OAuth, Basic, and API Key.
- Authentication parameters
Based on the chosen Authentication type, the parameters required for authenticating also differs.
Basic
- User name. Provide the username
- Password. Provide the password used for authentication.
IMPORTANT: Some of the connectors might use API key as the User name and the API token as the Password. For example, Ping Identity uses the API key and API token,
OAuth
Depending on the Grant Type selected, the following options are displayed. Th available options are password, client_credentials, Bearer_Token
- password
- Token URL. Provide the URL of the token.
- User name. Provide the username.
- Password. Provide the password .
- Client id. Provide the client id used to login.
- Client secret. Provide the client secret.
- client_credentials
- Token URL. Provide the URL of the token.
- Client id. Provide the client id used to login.
- Client secret. Provide the client secret.
- Bearer_Token
- Bearer token. Provide the bearer token.
IMPORTANT: A connection established using the bearer token has a time-limit, specified by the token provider. After the expiration of the time-limit, the connection is discontinued. A new token must be created to establish a new connection session.
API_Key
- Key. Provide the API key.
- Token. Provide the API token.
-
Click Finish to create a connection to a SCIM connector.
This section assumes that the SCIM connector is created through which can read the data. For more information, see Creating a SCIM connection.
To modify connection settings
- In the Administration Console, 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, see Creating a SCIM connection.
- When you are finished, click Save.