Skip to content

Single sign-on

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.

Provider form: Identity provider (SAML 2.0)

Section titled “Provider form: Identity provider (SAML 2.0)”
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.

Provider form: Identity provider (OpenID Connect)

Section titled “Provider form: Identity provider (OpenID Connect)”
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.
© 2026 Airowire Networks Pvt. Ltd. Airgate is a product of Airowire.Product · Release notes · Security