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”.
What works with Entra ID
Section titled “What works with Entra ID”| 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. |
Before you begin
Section titled “Before you begin”- 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.comandgraph.microsoft.comover HTTPS.
Step 1: Register an app in Entra ID
Section titled “Step 1: Register an app in Entra ID”- Sign in to the Microsoft Entra admin center
(
https://entra.microsoft.com). - Go to Entra ID › App registrations (in older layouts Identity › Applications › App registrations) and select New registration.
- 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. - On the Overview page, copy the Application (client) ID and the Directory (tenant) ID.
Step 2: Add the Graph permissions
Section titled “Step 2: Add the Graph permissions”- In the app, open API permissions and select Add a permission › Microsoft Graph › Application permissions.
- Add:
User.Read.All: read the user object (UPN, display name, department, account enabled).GroupMember.Read.All: read the user’s group memberships (memberOfand, for nested groups,transitiveMemberOf).
- 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.
Step 3: Create a credential
Section titled “Step 3: Create a credential”Airgate supports a client secret or a certificate.
Client secret
- Open Certificates & secrets › Client secrets › New client secret.
- Enter a description and an expiry, then select Add.
- Copy the Value now; it is shown only once. Note the expiry date and renew the secret in Airgate before then.
Certificate
- 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).
- Open Certificates & secrets › Certificates › Upload certificate and
upload the certificate (
.cer,.pemor.crt). - 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.
- 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. - Conditional Access policies that require MFA, a compliant device or a trusted location block ROPC. Exclude this app, or use certificates for those users.
Step 5: Add the directory in Airgate
Section titled “Step 5: Add the directory in Airgate”-
Open Access › Directories and select Add directory.
-
Under Cloud identity providers, select Microsoft Entra ID.
-
On the General tab, enter a Name, for example
Contoso Entra. -
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 secretorcertificateClient 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 -
Select Test connection. Airgate gets a token and lists one user.
-
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.
Step 6: Check a user
Section titled “Step 6: Check a user”- Select the directory in Access › Directories and open Test user.
- Enter a UPN, for example
alice@contoso.com. - Check that Groups lists the user’s Entra groups by display name.
Step 7: Use Entra ID in an access policy
Section titled “Step 7: Use Entra ID in an access policy”- Open Access › Access policies and open the policy for your SSID (or Add a policy › Employees).
- 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. - Under Allowed methods, select EAP-TLS and, if you use passwords, EAP-TTLS or PAP.
- Select Add a rule: When › Add condition › User is in group ›
Contoso Entra›Staff(the group’s display name); Then › Allow, VLAN20. Select Done. - Select Save changes.
How Airgate keeps Entra ID fast
Section titled “How Airgate keeps Entra ID fast”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.
Verify
Section titled “Verify”- 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.
- The result shows the matched rule. Step-by-step details lists the groups returned by Entra ID.
- After a real sign-in, open the entry in Monitor › Sign-in log. The
Computed attributes tab shows
Authorization:Contoso Entra:Groups.
Troubleshooting
Section titled “Troubleshooting”| 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. |
Related
Section titled “Related”- Intune SCEP with Airgate
- Device compliance policy
- Console sign-in with SSO
- BYOD onboarding (Microsoft sign-in uses this app)