Single sign-on (SSO) with your identity provider (OpenID Connect)
Let your team sign in to Omnifox with their company account from Microsoft Entra ID, Google Workspace, Okta or any other OpenID Connect provider.
Watch this step in the video · Single sign-on
With single sign-on (SSO), your team signs in to Omnifox with your company account instead of a separate password. When someone leaves the company, your IT team disables their corporate account once and they lose access to Omnifox at that very moment. On top of that, your identity provider's two-factor policy applies when they sign in.
Important: Omnifox works with providers that support OpenID Connect (OIDC). SSO with SAML doesn't exist yet: it's Coming soon (from the Crece plan). If your provider only supports SAML, message us in the chat and we'll look into it.
Plan: single sign-on with OpenID Connect is available from the Crece plan (also on Escala and Exclusivo). On lower plans the screen shows an upgrade notice, and signing in with the company account is turned off.
It works with any provider that publishes an OIDC discovery document, such as Microsoft Entra ID (Microsoft 365), Google Workspace, Okta, Auth0, Keycloak or Ping. SSO is a new feature: if your company will rely on it to sign in, test it carefully before requiring it for the whole team.
Before you start
- To set it up you need the Owner or Admin role in the organization. A supervisor can see the screen but can't change it.
- The configuration belongs to the organization (it applies to all its workspaces).
- Someone with access to your identity provider needs to register an application for Omnifox and give you three values: the Issuer URL, the Application (client) ID and the Application (client) secret.
Step by step
- Go to Settings → Organization settings and, in the left-hand menu, open Single Sign-On (SSO).
- Copy the Redirect URL shown on the screen (with the Copy button) and register it in the application you created in your identity provider. It must match exactly, or sign-in will fail.
- Under Identity provider, choose Microsoft Entra ID (Microsoft 365), Google Workspace or Another OIDC-compatible provider.
- Fill in the Issuer URL:
- Microsoft Entra ID:
https://login.microsoftonline.com/{tenant}/v2.0, replacing{tenant}with your Microsoft directory ID. - Google Workspace: exactly
https://accounts.google.com. - Another provider: your provider's base address; Omnifox finds its discovery document automatically.
- Microsoft Entra ID:
- Paste the Application (client) ID and the Application (client) secret. The secret is stored encrypted and never shown again; if one is already saved, leave the field empty to keep it or type a new one to replace it.
- Under Allowed email domains, enter one per line (for example,
company.com). Only addresses on those domains can sign in through this provider. - Decide whether to Create accounts automatically: when it's on, a person from an allowed domain signing in for the first time gets an account without a prior invitation. Choose the Role for new accounts (agent or admin).
- Click Test connection. If everything is right, you'll see a success message with your provider's name.
- Check Enable single sign-on and click Save.
- Sign in yourself with SSO (in another window or a private window) to confirm it works.
- Only then, if you want, turn on Require SSO: addresses on the allowed domains will no longer be able to sign in with a password. If you turn it on before confirming that SSO works, your team may get locked out.
How your team signs in
- On the Omnifox sign-in screen, each person types their work email and clicks Sign in with my company account (no password needed). Omnifox sends them to your identity provider and, on the way back, straight into Conversations.
- You can also share the Direct link for your team shown on the SSO screen: it goes straight to your provider without typing the email.
- People who sign in with SSO skip Omnifox's own two-step verification: two-factor is enforced by your identity provider.
- Each account created automatically takes up a user seat in your plan. If there are no free seats, the person can't get in until an admin adds more under Settings → Billing.
- If Create accounts automatically is off, invite each person first from Settings → Members (see Invite your team and assign roles).
Troubleshooting
- "There is no single sign-on configured for that email domain." The email's domain isn't in Allowed email domains, or SSO isn't enabled. Check both and save.
- "We could not reach your identity provider", or Test connection fails. The issuer URL is mistyped or isn't the right base address. For Microsoft Entra ID, make sure you replaced
{tenant}; for Google, use exactlyhttps://accounts.google.com. - "We could not validate the response from your identity provider." Usually a wrong client ID or secret, an expired secret, or a redirect URL that doesn't match. The SSO screen shows the Last error reported by the provider to help you find it.
- "Your account does not exist in Omnifox" or "Your account does not belong to this organization." Automatic account creation is off and that person wasn't invited. Invite them or turn on Create accounts automatically.
- "That account does not belong to an allowed domain." The person picked an account from another domain in their provider. They need to sign out and choose their work account.
- "Your organization has no free seats on its plan." Add users under Settings → Billing or free one up.
- "Your company requires signing in with the corporate account." Require SSO is on: that person must use the Sign in with my company account button.
- "The sign-in session expired." Too much time passed between leaving for the provider and coming back, or it was opened in another browser. Start again from the beginning.
More on security: How to enable two-factor authentication (2FA) and User roles and permissions.
Related articles
-
How to enable two-factor authentication (2FA)
Protect your Omnifox account with a second factor from an authenticator app, step by step.
-
Create your own help center for your customers
Publish FAQ articles on a public page with your brand color so your customers can solve their questions without opening a conversation.
-
Data protection and GDPR for companies in the European Union
What Omnifox offers today to help you comply with GDPR: data export and deletion, security, where data is hosted, the data processing agreement (DPA) and what doesn't exist yet.
-
Settings and security complete guide
Settings and security in depth, in 32 chapters: organization, workspaces, members and roles, teams, hours, SLA, notifications, two-factor authentication, passwords, sessions, IP allowlist, audit and privacy.
-
User roles and permissions
Learn how to invite users, assign roles, and control what each member of your team can do.