The Single sign-on page connects the console to identity providers (IdPs) so administrators sign in with their work account instead of a local password. It supports SAML 2.0 and OpenID Connect, for example Microsoft Entra ID, Okta or Google.
Settings › Administration › Single sign-on lists the identity providers configured for the tenant. Below the table, a note reminds you that local accounts keep working: administrators can still sign in with a password, or choose Sign in with SSO on the sign-in page.
Administrator accounts are created on the first successful SSO sign-in. Every administrator who signs in through a provider becomes a Tenant Administrator; there is no group or app-role mapping to other operator profiles yet. Limit who can sign in at the IdP itself (for Entra ID: Enterprise application › Properties › Assignment required, then assign users under Users and groups).
| Column |
Meaning |
| Provider |
Provider name and protocol (SAML 2.0 or OpenID Connect). |
| Email domains |
The domains routed to this provider, for example @contoso.com. |
| Role |
Always Everyone: Tenant Administrator. |
| Admins |
Number of administrator accounts the provider has created. |
| Status |
On or Off. If the last sign-in attempt failed, Last error and how long ago; hover to read the error. |
| Last sign-in |
Time of the last sign-in through this provider, or Never. |
| Field |
Meaning |
| Name |
Required. Defaults to Microsoft Entra ID (SAML) or Microsoft Entra ID. |
| Email domains |
Required. Type a domain such as contoso.com and press Enter. Sign-ins for these domains go to this provider, and only these domains can sign in through it. |
| Enabled (shown on the sign-in page) |
When off, the provider is not offered for sign-in. A test sign-in still works. |
| Field |
Meaning |
| Metadata URL / Paste metadata XML |
Choose how to supply the IdP metadata. |
| App federation metadata URL |
The IdP metadata URL. For Entra ID: Enterprise application › Single sign-on › SAML certificates. |
| IdP metadata XML |
The <EntityDescriptor …> document. For a saved provider, the stored XML is kept until you paste new metadata. |
| Check metadata |
Reads the metadata and shows the IdP Entity ID, Sign-on URL and Signing certificates with days to expiry (red under 30 days). If no sign-on URL appears, the IdP must offer the HTTP-Redirect binding. |
| Field |
Meaning |
| Entra ID directory (tenant) ID |
Optional helper. Typing an Entra tenant ID fills Issuer URL with https://login.microsoftonline.com/<tenant>/v2.0. Leave empty for other providers. |
| Issuer URL |
Required. Okta: https://<org>.okta.com. Google: https://accounts.google.com. |
| Client (application) ID |
Required. The application’s client ID at the IdP. |
| Client secret |
Required. The application’s client secret. |
| Extra scopes |
Optional, space separated. openid email profile are always requested. |
Leave these empty to use the usual names.
| Field |
Default claims looked up |
| Email |
SAML: NameID, emailaddress, email, mail. OIDC: email, preferred_username, upn. |
| Display name |
SAML: displayname, name, givenname + surname. OIDC: name. |
| Groups / roles |
SAML: groups, role, memberOf. OIDC: groups, roles. |
The right column of the form shows the addresses to register at the identity provider, each with a copy button. For a new provider they are reserved as soon as the form opens, so you can register them before you select Add provider; if you cancel, they are discarded.
| Field |
Meaning |
| Identifier (Entity ID) |
SAML: Airgate’s service provider entity ID. |
| Reply URL (Assertion Consumer Service URL) |
SAML: where the IdP posts the assertion. |
| Sign on URL |
SAML: the URL that starts sign-in. |
| Redirect URI (Web) |
OpenID Connect: the redirect URI to register on the application. |
| Home page URL (optional, branding only) |
OpenID Connect: optional. |
If these addresses start with http://, a warning explains that the server’s public URL is plain HTTP; most IdPs accept only HTTPS.
| Action |
What it does |
| OpenID Connect / SAML 2.0 |
Opens the form for a new provider of that protocol. Add provider saves it. |
| Select a row |
Opens the provider form. Save stores changes; Close closes the form. |
| SP metadata XML |
For a saved SAML provider, downloads Airgate’s service provider metadata to import at the IdP. |
| Test |
Starts a test sign-in at the IdP without signing you in to the console. When you return, the Test sign-in window shows whether the user can sign in, the email, name, role and groups received (matched groups in green), and Everything the IdP sent: every claim. |
| Delete (trash icon) |
After confirmation, deletes the provider. Administrators it created can no longer sign in and are disabled. Local administrators are not affected. |
- View: any role with
admin:read: Tenant Administrator, Network Administrator, Read-only Administrator and Platform Administrator.
- Change:
admin:write: Tenant Administrator and Platform Administrator. Only these roles see the add buttons, can open a provider and can delete one.