multi-router.aidocs

Single Sign-On

Microsoft Entra IDEnterprise

Registering Multi-Router in Microsoft Entra ID and connecting it.

Microsoft Entra ID, formerly Azure AD, connects to Multi-Router as an app registration using OpenID Connect. The app registration gives Multi-Router a client ID and secret, and the matching enterprise application decides which people can sign in. This page covers the Entra side; the Multi-Router side is on Setting Up SSO.

Registering the app

The app is registered in the Microsoft Entra admin center:

  1. Open App registrations, under Entra ID, and select New registration.
  2. Name the app, such as Multi-Router, and choose Accounts in this organizational directory only.
  3. Under Redirect URI, choose Web and enter https://dashboard.multi-router.ai/sso/callback, then select Register.
  4. Copy the Application (client) ID and the Directory (tenant) ID from the Overview page.
  5. Open Certificates & secrets, add a New client secret, and copy its Value.

Client secrets expire, after 6 months by default and at most 24. Before a secret expires, add a new one and enter it as the Client secret in Multi-Router, so sign-in continues.

The email claim

Multi-Router reads each person's email from the ID token's email claim. In the app registration, open Token configuration, select Add optional claim, choose ID, and add email, accepting the Microsoft Graph email permission Entra offers. The claim carries each user's Mail attribute, so every person who signs in has a Mail value in the company's email domain, the domain set on the SSO connection.

The issuer

The issuer for an Entra tenant is https://login.microsoftonline.com/ followed by the tenant ID and /v2.0, such as https://login.microsoftonline.com/7c1f4a2e-5b3d-4e8f-9a6b-2d1c3e4f5a6b/v2.0.

Connecting it to Multi-Router

On the Single Sign-On (SSO) page in Multi-Router:

  1. Choose Microsoft Entra ID as the Identity provider and enter the company's email domain.
  2. Enter the issuer, the Application (client) ID as the Client ID, and the secret's Value as the Client secret.
  3. Choose New-user access and the organization, select Test connection, then Set up SSO.
  4. Verify the domain with the DNS TXT record the page shows.
  5. From a private browser window, sign in with an Entra user.

Assignments and access

To limit sign-in to chosen people, open Enterprise apps, under Entra ID, select the Multi-Router app, set Assignment required to Yes under Properties, and add users or groups under Users and groups. Entra then signs in only the assigned people. To create and suspend people in Multi-Router from Entra, connect user provisioning. See Microsoft Entra ID provisioning.

OktaGoogle Workspace
Was this helpful?