Skip to content
Last updated

Azure AD integration

Integrating Microsoft Entra ID (Azure AD) with Frontegg allows your application to read and manage users, groups, applications, and directory roles in a Microsoft Entra tenant through the Microsoft Graph API — all via Frontegg's integration layer using OAuth 2.0.


Prerequisites

  • A Microsoft account with access to the Azure portal
  • A Microsoft Entra ID (Azure AD) tenant where you can register applications

Register an application in Azure

Step 1: Open App registrations

Sign in to the Azure portal and open App registrations (you can search for it in the top search bar or open it directly from Microsoft Entra ID → App registrations). Click New registration at the top of the page.

App registrations page in Azure portal

Step 2: Register a new application

Fill in the registration form:

  1. Enter a name for your application (for example, Frontegg Integration).
  2. Under Supported account types, select Accounts in any organizational directory (Any Microsoft Entra ID tenant — Multitenant) for multi-tenant apps, or Accounts in this organizational directory only for a single-tenant app.
  3. Under Redirect URI, choose Web as the platform and enter:
    https://YOUR_MCP_GATEWAY_URL/integration-callback
  4. Click Register.

New application registration form with name, multitenant account type, Web platform, and redirect URI filled in

Step 3: Copy the Application (client) ID and Directory (tenant) ID

After registration, you are taken to the application Overview page. Copy both the Application (client) ID and the Directory (tenant) ID — you will need them when configuring the Frontegg portal.

Application overview page with Application (client) ID and Directory (tenant) ID highlighted

Create a client secret

Step 4: Open Certificates & secrets

In the left sidebar, under Manage, click Certificates & secrets. On the Client secrets tab, click New client secret.

Certificates and secrets page with New client secret button highlighted

Step 5: Add a description and expiry

In the Add a client secret panel, enter a description (for example, Frontegg Integration) and choose an expiry period. Click Add.

Add a client secret panel with description field filled in and Add button highlighted

Step 6: Copy the client secret value

The new secret appears in the list. Copy the Value immediately — it is only shown once. After you navigate away, you cannot retrieve it again.

Save your Client Secret now

The Client Secret value is only displayed once. After you leave this page, you can only see the secret ID — not the value. Store the value securely before continuing.

Client secret list showing the new secret with value blurred and highlighted

Configure API permissions

Step 7: Open API permissions

In the left sidebar, click API permissions, then click Add a permission.

API permissions page with Add a permission button highlighted

Step 8: Select Microsoft Graph

In the Request API permissions panel, click Microsoft Graph.

Request API permissions panel with Microsoft Graph highlighted

Step 9: Select delegated permissions

Click Delegated permissions. Use the search box to find each permission you need and select the checkbox next to it. Select the following scopes:

ScopeDescription
openidSign users in
profileView users' basic profile
emailView users' email address
offline_accessMaintain access to data the user has granted (issues refresh tokens)
User.Read.AllRead all users' full profiles
User.ReadWrite.AllRead and write all users' full profiles
Group.Read.AllRead all groups
Group.ReadWrite.AllRead and write all groups
Application.Read.AllRead applications
Directory.Read.AllRead directory data

Click Add permissions.

Delegated permissions list with selected Microsoft Graph scopes

Step 10: Verify configured permissions

After adding permissions, the API permissions page lists all configured permissions under Microsoft Graph. Permissions marked Admin consent required (such as User.Read.All, Group.Read.All, Directory.Read.All) will only be granted after an admin clicks Grant admin consent for {tenant}, or after each user explicitly consents during sign-in.

API permissions page showing all configured Microsoft Graph permissions

Configure the Frontegg portal

Once you have your Client ID, Client Secret, and Directory (tenant) ID, enter them in the Frontegg portal:

  1. Open the Frontegg portal and navigate to [ENVIRONMENT] → Integrations → Azure AD.
  2. Enter the Client ID and Client Secret in the corresponding fields.
  3. Optionally, enter the Directory (tenant) ID. Leave blank or set to common for multi-tenant applications; use a tenant GUID or domain for single-tenant applications.
  4. Select the required scopes.
  5. Click Save.

Keep your credentials secure

Never share or commit your Client Secret to version control.

Additional resources