Skip to content

Use Microsoft Entra ID accounts and groups

This guide connects Airgate to Microsoft Entra ID (formerly Azure AD). At the end, Airgate looks up Entra ID users and their groups for every sign-in, and your access rules can say “members of the Entra group Staff get VLAN 20”.

Sign-in method With Entra ID
EAP-TLS (certificates, for example from Intune SCEP) Airgate looks up the user named in the certificate and reads their groups from Microsoft Graph. Recommended.
EAP-TTLS with PAP, PAP Airgate checks the password with Entra ID using the resource owner password credentials (ROPC) flow. Fails for accounts that must use MFA or are blocked by Conditional Access.
PEAP-MSCHAPv2, MS-CHAP Not possible. Entra ID never gives out what MS-CHAPv2 needs. Use certificates.
  • A Microsoft Entra role that can register applications and grant admin consent (Application Administrator or Cloud Application Administrator, plus Privileged Role Administrator or Global Administrator for consent).
  • An Airgate administrator who can change directories and policies.
  • Airgate must reach login.microsoftonline.com and graph.microsoft.com over HTTPS.
  1. Sign in to the Microsoft Entra admin center (https://entra.microsoft.com).
  2. Go to Entra ID › App registrations (in older layouts Identity › Applications › App registrations) and select New registration.
  3. Enter a Name, for example Airgate directory. Under Supported account types, choose Accounts in this organizational directory only (Single tenant). Leave Redirect URI empty. Select Register.
  4. On the Overview page, copy the Application (client) ID and the Directory (tenant) ID.
  1. In the app, open API permissions and select Add a permission › Microsoft Graph › Application permissions.
  2. Add:
    • User.Read.All: read the user object (UPN, display name, department, account enabled).
    • GroupMember.Read.All: read the user’s group memberships (memberOf and, for nested groups, transitiveMemberOf).
  3. Select Grant admin consent for . Both permissions must show Granted with a green tick.

Keep the delegated User.Read permission that new registrations get by default: the password check (ROPC) signs in as the user with the scope openid.

Airgate supports a client secret or a certificate.

Client secret

  1. Open Certificates & secrets › Client secrets › New client secret.
  2. Enter a description and an expiry, then select Add.
  3. Copy the Value now; it is shown only once. Note the expiry date and renew the secret in Airgate before then.

Certificate

  1. Create an RSA key pair and a certificate (self-signed is fine). Keep the private key in PEM format (PKCS#1 or PKCS#8, not encrypted).
  2. Open Certificates & secrets › Certificates › Upload certificate and upload the certificate (.cer, .pem or .crt).
  3. You paste the certificate and its private key into Airgate in step 5.

Step 4: Allow password checks (only for TTLS/PAP)

Section titled “Step 4: Allow password checks (only for TTLS/PAP)”

Skip this step if all your users sign in with certificates.

  1. Airgate sends the client secret (or a signed certificate assertion) with each password check, so public client flows are not required. If Entra ID answers AADSTS7000218, open Authentication (or Authentication › Settings) and set Allow public client flows to Yes.
  2. Conditional Access policies that require MFA, a compliant device or a trusted location block ROPC. Exclude this app, or use certificates for those users.
  1. Open Access › Directories and select Add directory.

  2. Under Cloud identity providers, select Microsoft Entra ID.

  3. On the General tab, enter a Name, for example Contoso Entra.

  4. On the Connection tab, fill in:

    Field Value
    Directory (tenant) ID the tenant GUID from step 1, or your primary domain
    Application (client) ID the client ID from step 1
    Credential type secret or certificate
    Client secret the secret Value (with secret)
    Client certificate (PEM), Client certificate key (PEM) the certificate and its RSA private key (with certificate)
    Verify passwords (ROPC) On to check passwords for TTLS/PAP; off for certificate-only use
    ROPC scope openid (default)
    Transitive group membership On if you use nested groups
    Login endpoint, Graph endpoint leave the defaults (https://login.microsoftonline.com, https://graph.microsoft.com) unless you use a national cloud
  5. Select Test connection. Airgate gets a token and lists one user.

  6. Select Create source.

The default Filters & attributes map the user’s displayName, mail, userPrincipalName, department, jobTitle and more, and the groups’ displayName to the alias Groups and their id to GroupIds.

  1. Select the directory in Access › Directories and open Test user.
  2. Enter a UPN, for example alice@contoso.com.
  3. Check that Groups lists the user’s Entra groups by display name.
  1. Open Access › Access policies and open the policy for your SSID (or Add a policy › Employees).
  2. Under Check accounts in, select Add a directory… and pick Contoso Entra. For certificate sign-ins, Airgate also uses the directories in this list to look up groups.
  3. Under Allowed methods, select EAP-TLS and, if you use passwords, EAP-TTLS or PAP.
  4. Select Add a rule: When › Add condition › User is in group › Contoso Entra › Staff (the group’s display name); Then › Allow, VLAN 20. Select Done.
  5. Select Save changes.

A RADIUS sign-in has about 2.4 seconds for everything after the TLS handshake. After a quiet period, a lookup that first needs DNS, a new TLS connection to Graph and a new token can take longer than that. For every Entra ID directory used by sign-ins in the last two hours, Airgate therefore:

  • renews the Graph token 10 minutes before it expires, and
  • sends one small Graph request when Graph has not been called for 45 seconds, so a pooled connection stays open.

Nothing needs to be configured.

  1. Open Access › Test access, choose A person signing in, enter the UPN and set Signed in with to EAP-TLS (certificate) (no password) or TTLS (with the password). Select Run test.
  2. The result shows the matched rule. Step-by-step details lists the groups returned by Entra ID.
  3. After a real sign-in, open the entry in Monitor › Sign-in log. The Computed attributes tab shows Authorization:Contoso Entra:Groups.
Symptom Cause Fix
Test connection: AADSTS7000215 Wrong or expired client secret. Create a new secret and paste it.
Test connection: AADSTS700016 Wrong application ID, or the app is in another tenant. Check the client ID and tenant ID.
Test connection: graph returned HTTP 403 (grant User.Read.All and GroupMember.Read.All application permissions) Permissions missing or not consented. Step 2, including Grant admin consent.
Sign-in log: Wrong password, reason MFA or conditional access required (AADSTS50076) (also 50079, 50158, 53003) The account needs MFA, or Conditional Access blocks ROPC. Use certificates for these users, or exclude the app from the policy.
Sign-in log: Airgate couldn’t reach the directory, reason application/tenant misconfigured (AADSTS7000218) Entra ID wants public client flows for ROPC. Step 4.
Sign-in log: No account named “…” The certificate CN or the typed name is not a UPN of this tenant. Use CN={{UserPrincipalName}} in the SCEP profile; users type their UPN.
Sign-in log: The account has expired, reason password expired The Entra password expired. The user changes the password.
Groups are empty GroupMember.Read.All is not consented, or the user is only in nested groups. Grant consent; turn on Transitive group membership.
Occasional Airgate couldn’t reach the directory after a quiet night The first lookup after a long idle period. Retry; Airgate keeps the directory warm after the first sign-in. Check outbound HTTPS to Microsoft.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security