# Azure Ad · Authentication Backends · Admin Portal

Register Mint Service Desk in Microsoft Entra ID, configure OpenID sign-in and map Azure groups to agent roles.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-azure-ad
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452e-170c-7cf6-a615-93cd6c97971b"></a>

## Registering the application

First go to <https://portal.azure.com>
Sign in and go to **Microsoft Entra ID** services.

<a id="element-01a1452e-170c-78f2-adf4-7fff84ced1d2"></a>

![Azure Ad: First go to https://portal.azure.com Sign in and go to Microsoft Entra ID services.](https://docs.mintsd.com/api/reader/assets/assets/images/image816.png?v=60bd21eb63059543d8cddb7251ce32f7b58c2163e58ce637a90f1305dd587e28)

<a id="element-01a1452e-170d-70d1-8901-ebe42f44d192"></a>

Go to “App” and ‘App registration’

<a id="element-01a1452e-170d-7ea7-a62e-874953075dba"></a>

![Azure Ad: Go to “App” and ‘App registration’.](https://docs.mintsd.com/api/reader/assets/assets/images/image945.png?v=08c40f870cce2c76dded71a286c24cfde0c9a588b13c615fb1f6105b357a45a2)

<a id="element-01a1452e-170e-70b1-bd98-1b0e80f91ce2"></a>

The following form will appear.

<a id="element-01a1452e-170e-7c50-92d9-e80afd359030"></a>

![Azure Ad: The following form will appear.](https://docs.mintsd.com/api/reader/assets/assets/images/image817.jpg?v=3ca9c2bb044d3bffe633800a103f86b166f6fb8d798591d1a0f51bca57fa1063)

<a id="element-01a1452e-170f-7d75-8579-76e869a4f43f"></a>

Complete the registration form:

<a id="element-01a1452e-1711-716c-8f72-84e511517462"></a>

- 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

<a id="element-01a1452e-1712-7087-8c3d-f70a88eb9411"></a>

In ‘Implicit Grant’ section check **ID tokens**

<a id="element-01a1452e-1712-749f-81d1-0375ee065861"></a>

![Azure Ad: In ‘Implicit Grant’ section check ID tokens.](https://docs.mintsd.com/api/reader/assets/assets/images/image818.jpg?v=2cfb23ee05501cc666352b71764943e993ceb3cdfccce4b619a6c409a6319514)

<a id="element-01a1452e-1712-74be-a38b-c10b60a7bfaf"></a>

## Claims and API permissions

Go to **Token Configuration** tab.

<a id="element-01a1452e-1713-7f6a-bb5a-a1a70a7d8aae"></a>

Click on **Add optional claim**.

<a id="element-01a1452e-1714-7e1f-a408-42a2d77728ce"></a>

Check **ID** token type and **email**, **given_name**, **family_name** claims.

<a id="element-01a1452e-1714-794e-b58b-5ecc2c1a5ce2"></a>

![Azure Ad: Check ID token type and email , given_name , family_name claims.](https://docs.mintsd.com/api/reader/assets/assets/images/image819.jpg?v=1bf74af097a4397d1795f53113a30dc4ec570dd1c58c9137e67919e515034df5)

<a id="element-01a1452e-1715-7927-bd68-94da2a0a9941"></a>

In case of a need to configure group mapping, click on **Add groups claim**. Now select all check-boxes
and click on **Add**.

<a id="element-01a1452e-1715-7fa7-8f56-7a2e578e46e5"></a>

![In case of a need to configure group mapping, click on Add groups claim. Now select all check-boxes and click on Add.](https://docs.mintsd.com/api/reader/assets/assets/images/image825.jpg?v=4e2dfb7e39a50afcaf3fffdae343e8e133366503abc11b0410fe25e1ccceb530)

<a id="element-01a1452e-1716-7a30-8600-167e843ece3a"></a>

Go into **API permissions** section.

<a id="element-01a1452e-1717-7fce-a0c6-bfdd7ede372f"></a>

- click on **Add a permission**
- select **Microsoft Graph**

<a id="element-01a1452e-1717-702d-b8f6-caeabf64aa15"></a>

![Azure Ad: click on Add a permission select Microsoft Graph.](https://docs.mintsd.com/api/reader/assets/assets/images/image823.jpg?v=d052f4278bdf3d34968b479d4b6991ef2d06eab79331e4c460ace39492256e1f)

<a id="element-01a1452e-1719-7924-8f9a-53a493712d94"></a>

- select **Delegated permission** and check **email** and **profile**

<a id="element-01a1452e-1719-7448-8bd4-aff6e846760d"></a>

![Azure Ad: select Delegated permission and check email and profile.](https://docs.mintsd.com/api/reader/assets/assets/images/image824.jpg?v=26f35121c5d203df0c6fdc16f3648ef4b8a6d774508fb34d2d86f0103ce0a327)

<a id="element-01a1452e-171a-7920-927d-9badb8b43ec5"></a>

## Client secret

Go to **Certificates & secrets** tab.

<a id="element-01a1452e-171a-7944-9fac-8f3bcc96ce27"></a>

Add new client secret by clicking on **New Client secret**.

<a id="element-01a1452e-171b-782f-9a82-15b57b3a69c5"></a>

Copy the client secret using the copy button.

<a id="element-01a1452e-171b-7db1-8ea7-3395a5974b4d"></a>

![Azure Ad: Copy the client secret using the copy button.](https://docs.mintsd.com/api/reader/assets/assets/images/image820.jpg?v=e40cf24b75d9a5a3dff38d00dfc3984579de095671f9de3bf8a03b57bd04c7ea)

<a id="element-01a1452e-171c-7441-850d-7fa2f3163460"></a>

<a id="element-01a1452e-171d-7706-8ee5-6fcac1b06ddc"></a>

## Provider configuration in Mint

In the **Authentication Backends** section go to **OpenID Providers** click on ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452e-171c-7441-850d-7fa2f3163460) button, the following form will appear.

<a id="element-01a1452e-171e-727c-b520-2b39a436bee7"></a>

![In the Authentication Backends section go to OpenID Providers click on button, the following form will appear.](https://docs.mintsd.com/api/reader/assets/assets/images/image821.JPG?v=c1c4911028b257383b5b2025d450f866c355d730075565883c68a4eb45e28f6e)

<a id="element-01a1452e-171e-7e05-8cbd-43ab2c00ae0a"></a>

Complete the provider form:

<a id="element-01a1452e-1721-74ae-870d-bf310108a685"></a>

- 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

<a id="element-01a1452e-1721-7b29-9350-635fc2803e62"></a>

![Register Mint Service Desk in Microsoft Entra ID, configure OpenID sign-in and map Azure groups to agent roles.](https://docs.mintsd.com/api/reader/assets/assets/images/image1260.png?v=1287f2b1a9f679e595cd4c57ff0ca7af1083d80ec3def166b077fab405646df9)

<a id="element-01a1452e-1722-7f20-8c09-079eff771b27"></a>

- in **Tenant Id** field paste the value from registered app overview

<a id="element-01a1452e-1722-7fd9-8ce1-c9f43499d626"></a>

![Azure Ad: in Tenant Id field paste the value from registered app overview.](https://docs.mintsd.com/api/reader/assets/assets/images/image822.jpg?v=046328a3dbe2100b6bfe47465d774d83dd1de897195df3786cf3f37b72e80bbc)

<a id="element-01a1452e-1724-7357-813a-5941b7274928"></a>

- 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.

<a id="element-01a1452e-1724-7ce7-ae95-bc96ff7ea41b"></a>

![Azure Ad: in Groups claim field, enter the name: ‘groups’.](https://docs.mintsd.com/api/reader/assets/assets/images/image1263.png?v=2b47dd3b559ac77a6b020d05c07d63d1c5f2ef1a6ad81a2e8e398ad48d9fbf07)

<a id="element-01a1452e-1725-74bf-b508-d23874a9c0e4"></a>

> You will find the group ID in Azure AD under the path: **Home > Microsoft Entra ID > Manage (sidebar) > Groups (sidebar) > All groups (sidebar)**

<a id="element-01a1452e-1725-7b38-87cf-eacab2a6fd0d"></a>

![You will find the group ID in Azure AD under the path: Home > Microsoft Entra ID > Manage (sidebar) > Groups (sidebar) > All groups (sidebar).](https://docs.mintsd.com/api/reader/assets/assets/images/image1261.png?v=158d1462681b67c5a2d58c8a44189da8afde94056acb4f8b615dc186f824f240)

<a id="element-01a1452e-1726-7917-851f-17d3a629d0b0"></a>

![You will find the group ID in Azure AD under the path: Home > Microsoft Entra ID > Manage (sidebar) > Groups (sidebar) > All groups (sidebar).](https://docs.mintsd.com/api/reader/assets/assets/images/image1262.png?v=d9c1732f424d98aa1fa9dec7846d99058e2e2278297fc280ce46f968ad8102ce)

