Skip to content
Omnixi Omnixi Omnixi Help

SSO

Single Sign-On (SSO) lets your team log in to Omnixi using their existing Microsoft or Google accounts — no separate passwords needed. This guide walks you through setting up SSO with Azure Active Directory (Azure AD) or Google Workspace.

Prerequisites

Section titled “Prerequisites”

Before you begin, make sure you have:

  • Admin access to Azure AD or Google Workspace — you’ll need to create an enterprise application
  • Admin access to Omnixi Portal — to complete the SSO configuration
  • A list of users who should have Portal access — you can sync these from your identity provider

Setting up Azure AD SSO

Section titled “Setting up Azure AD SSO”

Create an enterprise application

Section titled “Create an enterprise application”
  1. Sign in to the Azure Portal (portal.azure.com) as an admin
  2. Go to Azure Active Directory → Enterprise applications
  3. Click New application
  4. Click Create your own application
  5. Name it “Omnixi” (or similar)
  6. Select Integrate any other application you don’t find in the gallery (Non-gallery)
  7. Click Create

Setting up Google SSO

Section titled “Setting up Google SSO”

Create a SAML application

Section titled “Create a SAML application”
  1. Sign in to the Google Admin Console (admin.google.com) as an admin
  2. Go to Apps → Web and mobile apps
  3. Click Add app → Add custom SAML app
  4. Enter “Omnixi” as the app name
  5. Click Continue

After enabling SSO

Section titled “After enabling SSO”

How users log in

Section titled “How users log in”

Once SSO is enabled, the login page changes:

  1. Users go to portal.omnixi.app
  2. They click Sign in with Microsoft or Sign in with Google
  3. They’re redirected to authenticate with their organisation
  4. They’re automatically logged into Omnixi

First-time login

Section titled “First-time login”

On first login via SSO:

  • An Omnixi account is created automatically
  • Their name and email are pulled from the identity provider
  • They’re assigned to teams based on their identity provider groups (if configured)

Managing users

Section titled “Managing users”

When SSO is enabled:

  • New users — if they’re in your identity provider and assigned to the Omnixi app, they can log in automatically
  • Removing access — remove them from the identity provider group or disable their account there
  • Updating details — changes to name/email in your identity provider sync to Omnixi on next login

Troubleshooting

Section titled “Troubleshooting”

Users can’t log in

Section titled “Users can’t log in”
ProblemSolution
”Account not found”Check the user is assigned in your identity provider
”Not authorised”Check the user’s email domain matches your SSO configuration
Wrong password promptMake sure you’re clicking the SSO button, not entering a password

Setup not working

Section titled “Setup not working”
  • Test the connection — use the “Test Connection” button in the Portal before enabling
  • Check the metadata URL — make sure it’s accessible and valid
  • Verify attribute mapping — ensure email maps correctly (this is required)

Lost admin access

Section titled “Lost admin access”

If you’re locked out after enabling SSO:

  1. Contact Omnixi support — they can disable SSO temporarily
  2. Use the backup admin account you set up before enabling SSO