Skip to content
Mint Service Desk Documentation centre

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)