When migrating your directory to Omnissa Identity Service, you must synchronize the required user and group attributes from on-premises Active Directory to your cloud identity provider, and then map them to SCIM attributes for Omnissa Identity Service. These attributes are necessary for Omnissa Identity Service to properly identify and manage users and groups.
Required Attributes for Microsoft Entra ID
If Microsoft Entra ID is your identity provider, ensure that the following attributes are synchronized from Active Directory to Entra ID and mapped correctly in the provisioning app for Omnissa Identity Service.
Required User Attributes (Entra ID)
| Active Directory | Entra ID | SCIM (Omnissa Identity Service) | Omnissa Services |
|---|---|---|---|
| sAMAccountName, if sAMAccountName is used as the username | onPremisesSamAccountName | userName Note: Mapping userName to Entra ID userPrincipalName is also an option. See "Critical Considerations" in Getting Started with Migration. | userName |
| objectId | externalId | externalId | |
| emails[type eq "work"].value | |||
| FirstName | givenName | name.givenName | firstName |
| LastName | surname | name.familyName | lastName |
| sourceAnchor | immutableId | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:adSourceAnchor | sourceAnchor |
| distinguishedName, if it is used as the unique common identifier (See "Critical Considerations" in Getting Started with Migration) | onPremisesDistinguishedName | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:distinguishedName | distinguishedName |
| objectGUID, if objectGUID is used as externalId | immutableId or <ad.objectGUID> (custom attribute mapping objectGUID from Active Directory) | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:altExternalId Note: This mapping is required for migration only. We recommend you remove it after migration is complete. | altExternalId |
| Switch([IsSoftDeleted], "False", "True", "True", "False") | active Note: This attribute is set implicitly. You do not need to add it manually. | active | |
| Any additional attributes required for configured features |
Note:
- If you are migrating multiple domains, you must add the mapping for the domain attribute for both users and groups in the provisioning app.
- You can remove the mapping for the urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:altExternalId SCIM attribute from the provisioning app after migration is complete.
Required Group Attributes (Entra ID)
| Active Directory | Entra ID | SCIM (Omnissa Identity Service) | Omnissa Services |
|---|---|---|---|
| displayName | displayName | displayName | displayName |
| objectId | externalId | externalId | |
| distinguishedName, if it is used as the unique common identifier (See "Critical Considerations" in Getting Started with Migration) | onPremisesDistinguishedName | urn:ietf:params:scim:schemas:extension:ws1b:2.0:Group:distinguishedName | distinguishedName |
How to Map Additional Attributes in Entra ID
Certain attributes such as distinguishedName, objectGUID, and sAMAccountName are not directly available in the Entra ID user interface. You can use the following method to add these attributes:
-
In the Microsoft Entra admin center, navigate to the provisioning app you created for user provisioning to Omnissa Identity Service.
-
Select Manage > Provisioning.
-
On the Provisioning page, under Mappings, click Provision Microsoft Entra ID Users for users or Provision Microsoft Entra ID Groups for groups.
-
Edit the URL in the launch bar.
-
Add the query parameter:
Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=trueEnsure that you put the query parameter before the URL fragment
#. -
The old URL should be:
https://aad.portal.azure.com/#view/Microsoft_AAD_Connect_Provisioning/… -
The new URL should be:
https://aad.portal.azure.com/?Microsoft_AAD_Connect_Provisioning_forceSchemaEditorEnabled=true#view/Microsoft_AAD_Connect_Provisioning/…
-
-
Navigate to the new URL.
-
At the bottom of the page, select the Show advanced options check box, then click Edit attribute list for Microsoft Entra ID.

-
On the Edit Attribute List page, add a new row to the table with Name set to the new attribute.
- For the Active Directory attribute distinguishedName, use
onPremisesDistinguishedName. - For the Active Directory attribute objectGUID, use
immutableId. - For the Active Directory attribute sAMAccountName, use:
onPremisesSamAccountName
Note: These are the typical mappings for these attributes but they might be different in your environment. You can use the expression builder to verify the mappings used in your environment.
- For the Active Directory attribute distinguishedName, use
-
Click Save.
After you add the attribute, it will be available in the Source attribute column when you add or edit a mapping.
Required Attributes for Okta
If Okta is your identity provider, ensure that the following attributes are synchronized from Active Directory to Okta and mapped correctly in the provisioning app for Omnissa Identity Service.
Required User Attributes (Okta)
| Active Directory | Okta | SCIM (Omnissa Identity Service) | Omnissa Services |
|---|---|---|---|
| sAMAccountName, if sAMAccountName is used as the username | <ad.sAMAccountName> (custom attribute mapping sAMAccountName from Active Directory) | userName Note: Mapping userName to the Okta login identifier is also an option. See "Critical Considerations" in Getting Started with Migration. | userName |
| user.email | |||
| emailType | (user.email != null && user.email != '') ? 'work' : '' | ||
| FirstName | user.firstName | name.givenName | firstName |
| LastName | user.lastName | name.familyName | lastName |
| sourceAnchor | sourceAnchor | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:adSourceAnchor | sourceAnchor |
| externalId | externalId Note: This attribute is set implicitly. You do not need to add it manually. | externalId | |
| objectGUID, if objectGUID is used as externalId | <ad.objectGUID> (custom attribute mapping objectGUID from Active Directory) | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:altExternalId Note: This mapping is required for migration only. We recommend you remove it after migration is complete. | altExternalId |
| active | active Note: This attribute is set implicitly. You do not need to add it manually. | active | |
| distinguishedName, if it is used as the unique common identifier (See "Critical Considerations" in Getting Started with Migration) | distinguishedName | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:distinguishedName | distinguishedName |
Required Attributes for Generic SCIM 2.0 Identity Providers
If you are using a generic SCIM 2.0-compliant identity provider, ensure that the following attributes are synchronized from Active Directory to your identity provider and mapped correctly in the provisioning app for Omnissa Identity Service.
Required User Attributes (Generic SCIM 2.0 IDP)
| Active Directory | SCIM (Omnissa Identity Service) | Omnissa Services |
|---|---|---|
| sAMAccountName, if sAMAccountName is used as the username | userName Note: Mapping userName to the cloud user identifier is also an option. See "Critical Considerations" in Getting Started with Migration. | userName |
| emails[type eq "work"].value | ||
| FirstName | name.givenName | firstName |
| LastName | name.familyName | lastName |
| externalId | externalId | |
| objectGUID, if objectGUID is used as externalId | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:altExternalId Note: This mapping is required for migration only. We recommend you remove it after migration is complete. | altExternalId |
| distinguishedName, if it is used as the unique common identifier (See "Critical Considerations" in Getting Started with Migration) | urn:ietf:params:scim:schemas:extension:ws1b:2.0:User:distinguishedName | distinguishedName |
| active | active |
Was this page helpful?