Configure SCIM provisioning for Microsoft Entra ID

Before you start

The SCIM provisioning for Microsoft Entra ID guide is written for Azure Active Directory administrators configuring user provisioning for Eptura using the Eptura SCIM API. It assumes familiarity with Entra ID, basic identity management concepts, and the SCIM standard.

Learn more: Prerequisites and supported actions.

How to configure SCIM for Eptura in Microsoft Entra ID

1. Sign into the Azure portal and open Microsoft Entra ID

2. Select Enterprise applications.
   
3. Click New application.
   

4. Click Create your own application.
   
5. Enter a name for the new application i.e. ‘EpturaScimApplication’ and select Integrate any other application you don’t find in the gallery. Click Create.
   

6. From the Overview page for your new application, click Get started in the Provision User Accounts box.
   
7. On the Provisioning page, click the Provisioning Mode drop-down and select Automatic then enter the Admin Credentials:
   1. Tenant URL: enter the Eptura SCIM URL i.e. https://<EPTURA-SCIM-Domain>/scim/v1/
   2. Secret Token: enter the token (provided by Eptura). Learn more: Eptura SCIM API token
      
8. Click Test connection and if successful, click Save to save your new application.
   
9. Still on the Provisioning page, scroll down and expand the Mappings section. Click Provision Microsoft Entra ID Users. 
   
10. The Attribute Mapping table must only contain the following customappsso attributes:

Mandatory attributes:

• userName
• active
• emails[type eq “work”].value
• name.givenName
• name.familyName
• externalId

Optional attributes:

• phoneNumbers[type eq “work”].value
• phoneNumbers[type eq “mobile”].value

Click Delete to delete mappings not listed above. The image shows only the required mappings.

Learn more: SCIM User attributes and the associated Eptura User attributes

11. Still on the Attribute Mapping page, click “externalId” mapping from the 'customappsso Attribute' column and change the values as follows:

Mapping type: Direct
Source attribute: objectId
Default value if null (optional): leave blank
Target attribute: externalId
Match objects using this attribute: No
Apply this mapping: Always

12. Click OK to save the values.
13. Click Save to save the Attribute Mappings and click Yes to confirm.
14. Expand the Mappings section and click Provision Microsoft Entra ID Groups.
    
15. Click Yes to enable Provision Azure Active Directory Groups, then click Save.
    
16. The Attribute Mapping page is displayed. Edit the group attributes as follows:
    1. Click the group attribute “displayName” and change Matching precedence to 2.
       
    2. Click OK to save and return to the Attribute Mapping page.
    3. Click the group attribute “objectId” to open the Edit Attribute page. Click Match object using this attribute and select Yes. Check the Matching precedence value is 1.
       
    4. Click OK to save and return to the Attribute Mapping page.
    5. Click the group attribute “displayname” again to open the Edit Attribute page. Click Match object using this attribute and select No. Check the Matching precedence value is empty.
       
    6. Click OK to save and return to the Attribute Mapping page.
       
17. Click Save to save the Attribute Mappings and click Yes to confirm.
18. Click X to close Attribute Mapping and return to the Provisioning Page.
19. Expand Settings, click the Scope drop-down list and select Sync all users and groups and set the Provisioning Status button to On.
    Note: If the Scope drop-down list is not visible, close the Provisioning page and click Edit Provisioning to reopen.
    
20. Click Save to complete the SCIM application provisioning.

Current cycle status

In the Manage navigation menu select Provisioning to view the status of the current or initial incremental cycle. Use the buttons at the top to manually start or stop provisioning, and click View Provision details to check the schedule for the next run.