Azure AD Settings
You can sync password resets and changes with Microsoft Entra ID (Azure AD). Before configuring the integration in the Gatekeeper Admin Tool, register an app in Microsoft Entra ID and assign it the required permissions.
Requirements
Before you configure Microsoft Entra ID integration, make sure you have the following:
- A Microsoft Entra ID tenant
- The required Microsoft Entra ID subscription
Configuring an App in Microsoft Entra ID
- Log in to the Microsoft Entra admin center.
- Click Microsoft Entra ID. This opens your organization's directory.
- Click App Registrations.
- Click New registration.
- Enter a name for the app in the Name field.
- Using the radio buttons, select the supported account type (Single Tenant or Multitenant).
- Click Register. In the following app summary screen, under the Essentials section, make a note (copy) of the Application (client) ID and the Directory (tenant) ID. These will be used for configuration.
- In the left navigation of the app summary screen, click Certificates & Secrets.
- Click New client secret. Enter a description and set an expiry period using the Expiry dropdown, then click Add.
-
Copy and securely store the client secret from the Value column. You will need the secret value for configuration.
Note
When configuring a sync point (Specops Password Sync), note that this value needs to be pasted in the Provider password field in the Sync Point configuration.
-
In the Microsoft Entra ID admin center's (left-most) left navigation, click on Microsoft Entra ID, then click on Roles and administrators.
-
In the list, click on a role that will be sufficient for resetting passwords.
Note
For an overview of roles and their permissions, please go to Working with users in Microsoft Graph. Note that the minimum required role for resetting passwords is the Password Administrator role.
-
Click Add assignments at the top. The Add Assignments sidebar will open on the right.
- In the search box, enter the registered app name, click on the app in the search result list, then click Add at the bottom.
- Write down or copy the Application (client) ID, Directory (tenant) ID, and the Client Secret, then proceed to configure the Microsoft Entra ID Settings in the Gatekeeper Admin Tool.
Configuring the Microsoft Entra ID Settings in Gatekeeper Admin Tool
- In the Gatekeeper Admin Tool, click Azure AD Settings.
- In the Azure AD Settings field, click Edit.
- Enter the Client ID value in Application (client) ID.
- Enter the Tenant ID value in Directory (tenant) ID.
- Enter the Client Secret value in Client Secret.
- Click OK.
- In the right navigation box, click Test connection to see if a connection to Microsoft Entra ID was established.
Once the connection is established, the Gatekeeper will start syncing with Microsoft Entra ID on password reset or password change.