Entra Authentication

Microsoft Entra authentication enables the DW application to be connected with the Microsoft Entra ID app. Users configured in the Microsoft Entra ID app can then be used to access the DW application.

Create app registration

  1. Go to Microsoft Entra ID -> App registrations -> New registration

    Figure 1: App registration

    ../_images/entra-1.png

    Figure 2: App registration 2

    ../_images/entra-1a.png
  2. Fill the name of the application, select “Accounts in this organizational directory only (Single tenant)” and click “Register”.

    Figure 3: App registration 3

    ../_images/entra-2.png

Set permissions

  1. Open the app registration and go to API permissions

    Figure 4: Set permission

    ../_images/entra-3.png
  2. Remove “User.Read” permission by clicking the three dots on the right side and select “Remove permission”

    Figure 5: Set permission 2

    ../_images/entra-4.png
  3. Click “Add permission”

    Figure 7: Set permission 3

    ../_images/entra-5.png
  4. Add a permission -> Microsoft Graph -> Application permissions -> User.Read.All

    Figure 7: Set permission 4

    ../_images/entra-6.png
  5. Add following permissions -> Microsoft Graph -> Delegated permissions -> openid, profile and email

    Figure 8: Set permission 5

    ../_images/entra-7.png
  6. Grant admin consent

    Figure 9: Set permission 6

    ../_images/entra-8.png

Create client secret

  1. Open the app registration and go to Certificates & secrets

    Figure 10: Create client secret

    ../_images/entra-9.png
  2. Create new client secret

    Figure 11: Create client secret 2

    ../_images/entra-10.png
  3. Copy and save the secret value

    Figure 12: Create client secret 3

    ../_images/entra-11.png

Add redirect URI

  1. Open the app registration and go to Authentication

    Figure 13: Add redirect URI

    ../_images/entra-12.png
  2. Platform configurations -> Add a platform -> Web

    Figure 14: Add redirect URI 2

    ../_images/entra-13.png
  3. Add Web redirect URI for tenant in following format https://{tenant ID}.2ring.cloud/realms/{tenant ID}/broker/entra_id/endpoint

    Figure 15: Add redirect URI 3

    ../_images/entra-14.png
  4. Contact 2Ring support and provide tenant id, client id and configured client secret.