Azure Ad
Register Mint Service Desk in Microsoft Entra ID, configure OpenID sign-in and map Azure groups to agent roles.
Registering the application
First go to https://portal.azure.com Sign in and go to Microsoft Entra ID services.
Go to “App” and ‘App registration’
The following form will appear.
Complete the registration form:
-
in ‘Name’ field type your preferred name
-
‘Supported Account Types’: leave it as it is
-
‘Redirect URL’: fill it with https://{your.mintsd.domain}/external/signin-{your-scheme}
- Replace {your.mintsd.domain} with your domain name
- Replace {your.scheme} with schema name which will be needed later on
-
After the registration go to the Authentication tab
In ‘Implicit Grant’ section check ID tokens
Claims and API permissions
Go to Token Configuration tab.
Click on Add optional claim.
Check ID token type and email, given_name, family_name claims.
In case of a need to configure group mapping, click on Add groups claim. Now select all check-boxes and click on Add.
Go into API permissions section.
- click on Add a permission
- select Microsoft Graph
- select Delegated permission and check email and profile
Client secret
Go to Certificates & secrets tab.
Add new client secret by clicking on New Client secret.
Copy the client secret using the copy button.
Provider configuration in Mint
In the Authentication Backends section go to OpenID Providers click on button, the following form will appear.
Complete the provider form:
- value from Name will appear on Login screen
- in Scheme field type value from one of the previous steps ({your.scheme})
- in Type field select AzureAd
- in Client secret field paste the value from previous step (‘Cerificates & secrets’ tab)
- in Client id field paste the value from registered app overview
- in Tenant Id field paste the value from registered app overview
- in Groups claim field, enter the name: ‘groups’. The new fields will appear below in Group mapping section. Paste ID of Azure group to Groups and select Agent role from Role to connect Azure group with Agent role. You can combine more groups under one claim by pressing Add button.
You will find the group ID in Azure AD under the path: Home > Microsoft Entra ID > Manage (sidebar) > Groups (sidebar) > All groups (sidebar)