Set up sign-in and single sign-on

Updated November 14, 2026 · Applies to Platform ONE 1.53

People can sign in with an email and password, with single sign-on (SSO) through your identity provider, or both. With SSO, people use their work account, and their roles can come from the provider.

Prerequisites

  • The Admin role.
  • SSO with Microsoft Entra ID or Google is available in the Professional and Enterprise editions. SSO with any other OpenID Connect provider is available in the Enterprise edition. See Plans and features.
  • An app registration at your identity provider, with its client ID and client secret.

Add an identity provider

  1. In the menu, under Administration, select Sign-in & SSO.

  2. Select Add provider.

  3. Choose the type: Microsoft Entra ID, Google or Other OpenID Connect.

  4. Enter the following information:

    Field Description
    Button label Shown on the sign-in page as "Sign in with …".
    Identifier A short name used in the provider's return address. It can't be changed later.
    Directory (tenant) ID Microsoft Entra ID only: the ID from the app registration's overview. Sign-ins from any other directory are refused.
    Authority / issuer URL Filled in for Microsoft Entra ID and Google. For another provider, enter its issuer address. It must start with https://.
    Client (application) ID From your app registration.
    Client secret From your app registration. It's stored encrypted; leave it blank later to keep it.
    Scopes What the app asks the provider for.
    Role claim The claim that carries the user's roles or groups. For Microsoft Entra ID: roles or groups.
  5. Register the Redirect URI shown on the page with your identity provider.

  6. Under Access, set the following:

    Field Description
    Create accounts automatically on first sign-in Turn it on to create an account for someone who signs in for the first time. Otherwise, only existing users can sign in.
    Allowed email domains The email domains that can sign in with this provider, both to existing accounts and to new ones. Empty means any domain.
    Trust this provider's email addresses Turn it on to trust email addresses the provider doesn't mark as verified or unverified. An address the provider marks as unverified is never trusted. It's on for Microsoft Entra ID and off for other providers. Turn it on for another provider only if it never lets people choose their own email address.
    Default role for new users The role of an account created at first sign-in.
    Role mappings (claim value=Role, one per line) Roles from the provider's claims, such as Platform-Admins=Admin. Microsoft Entra ID needs the Directory (tenant) ID for these.
    Enabled on the sign-in page Turn it on to show the provider's button.
  7. Select Test connection to check the provider's details, and then select Save.

The provider is live at once.

The Sign-in and SSO page, with local accounts and the identity providers

How SSO users get access

  • At their first sign-in, someone is linked to an existing account with the same email if the provider marks the address as verified or you trust the provider's email addresses, and their email domain is allowed. Otherwise, a new account is created if automatic accounts are on, under the same conditions.
  • If that account's address was never confirmed, for example a customer who signed up while Require email confirmation before first sign-in was off, its password is removed when it's linked, and the person signs in with the provider from then on. This stops someone from signing up with another person's address and waiting for them to arrive. The audit log records it as "Password removed".
  • If an account with the same email exists but can't be linked, the person is asked to sign in with their password once and connect the provider from My profile. See Manage your profile.
  • With Microsoft Entra ID, people from a directory other than yours can't sign in. If the Directory (tenant) ID isn't set, people from any Microsoft organization can sign in, so their email addresses aren't trusted: they aren't linked to existing accounts and no account is created for them, unless Microsoft confirms the address belongs to its domain's owner. Set the directory ID to limit sign-in to your organization.
  • Each link between an account and a provider is recorded in the audit log as "External sign-in linked".
  • Their roles come from the provider's claims, through your role mappings, or the default role.
  • Roles from your identity provider are added and removed at each sign-in. When someone leaves a mapped group, the role it gave them is removed the next time they sign in, and the change is recorded in the audit log. Roles you grant on the Users page stay, and the last administrator always keeps the Admin role.
  • With Microsoft Entra ID, role mappings apply only when the Directory (tenant) ID is set. Without it, an administrator of any Microsoft organization could give their own people the roles you map, so the mappings are ignored and the provider's form shows a warning. Roles a provider gave before are removed at the next sign-in.
  • Customers can connect only the providers set up for customers: those that create accounts automatically with the Customer role. Your staff sign-in providers aren't available to them.
  • The same access rules apply to SSO users and to users with a password.

Require two-factor sign-in

People who sign in with a password can turn on two-factor sign-in on My profile. To require it:

  1. In the menu, under Administration, select Sign-in & SSO.
  2. Under Two-factor sign-in, turn on Require two-factor sign-in for administrators, or Require two-factor sign-in for all staff.

Anyone it applies to who hasn't set it up is taken to My profile to set it up before they can go on, and can't turn it off. People who sign in through your identity provider (single sign-on) aren't affected: set up a second step there. Every edition includes two-factor sign-in. See Set up two-factor sign-in.

Repeated attempts are slowed down

Too many sign-in, sign-up or password-reset attempts from one network in a minute are refused for a minute, with a message saying to wait. At most three password-reset or confirmation emails go to one address an hour.

Allow only single sign-on

  1. Under Local accounts, turn off the switch.

People must then sign in with an identity provider. Administrators can still sign in with their password: the sign-in page shows Administrator sign-in for that, in case the provider is unavailable. Other people can't sign in with a password to connect a provider themselves, so make sure they can be linked automatically: the provider marks email addresses as verified, or you trust its email addresses. While no provider is enabled, sign-in with a password stays available to everyone.

Remove a provider

  1. On the provider, select Remove, and then confirm.

Users who only sign in with that provider can no longer sign in.

Note

If your edition no longer includes SSO, your providers are kept but not offered on the sign-in page, and people sign in with their email and password.

The Customer accounts settings on this page apply to products where customers book online. They're described in those products' administrator guides.

Next steps