SSO Configuration for Okta Customers
Safety AZ allows users to login via Okta as Single Sign-On (SSO) using Express Configuration. This document details how to configure SSO for your organization.
Prerequisites
In order to proceed with configuring login with SSO through Okta, you must:
- Have access to an Okta tenant
- Be an Okta administrator to that tenant
- Have an active Safety AZ enterprise license with available seats
Supported Features
- Service Provider (SP)-Initiated Authentication (SSO) Flow - This authentication flow occurs when the user attempts to log in to the application from Safety AZ.
- Just-In-Time (JIT) Provisioning - Users are automatically created on their first login if your enterprise license has available seats. Email and name attributes are provisioned.
- Universal Logout - When enabled, Okta can terminate user sessions and tokens when risk is detected or when an admin initiates logout.
Configuration Steps
Request Admin Account
Send an email to salut@safety-az.com with the email address you want to use for the Express Configuration admin account.
Receive Credentials from Safety AZ
Safety AZ support will create an admin account and reply with:
- A temporary password
- An organization name unique to your company
Add Safety AZ Application in Okta
- In Okta, go to Applications → Browse App Catalog
- Search for Safety AZ and click Add Integration
- Click Done
Express Configure SSO
- On the newly created Safety AZ application, click the Sign On tab
- Click Express Configure & Universal UL
- Enter the organization name provided by Safety AZ
- When prompted for credentials, enter the admin email and temporary password provided by Safety AZ
- On the next screen, approve the connection with Safety AZ to complete the setup
Enable Universal Logout
- On the Sign On tab of the Safety AZ application
- Check the box for Okta system or admin initiates logout
Notify Safety AZ
Send an email to salut@safety-az.com to confirm that you have completed the Express Configuration setup.
Safety AZ support will then:
- Enable home realm discovery for your domain
- Enable application access so your users can log in
Wait for confirmation from Safety AZ before proceeding to the next step.
Assign Users and Test
Once Safety AZ has confirmed the setup is complete:
- Assign the admin account to the Safety AZ application in Okta
- Assign any other users or groups that should have access to Safety AZ
- Test the login flow by navigating to safety-az.com and logging in with the admin account
- You should be automatically redirected to your Okta SSO login
Confirm Completion
After successfully testing the login flow, send a final email to salut@safety-az.com to confirm everything is working.
Safety AZ will then remove the temporary admin account as it is no longer needed.
SP-Initiated SSO (Logging Into Safety AZ Using Okta)
The sign-in process is initiated from Safety AZ.
- From your browser, navigate to safety-az.com
- Click the Log In button
- Enter your enterprise email address
- You will be automatically prompted to authenticate with Okta
- Enter your Okta credentials (email and password) and sign in
- If your credentials are valid, you are redirected to the Safety AZ dashboard.
Universal Logout
When Universal Logout is enabled, Okta can terminate user sessions across all applications when:
- An administrator initiates a logout from the Okta Admin Console
- The Okta system detects risk and terminates sessions for security
This ensures that when a user is logged out of Okta, they are also logged out of Safety AZ.
Just-In-Time (JIT) Provisioning
With JIT provisioning enabled, users are automatically created in Safety AZ when they first sign in via Okta.
How it works:
- When a user authenticates via Okta for the first time, Safety AZ checks if your enterprise license has available seats
- If seats are available, a new user account is automatically created with the email and name from Okta
- The user is granted access to Safety AZ immediately
- If no seats are available, the user will be notified and will not be able to access Safety AZ
Attributes Provisioned:
- Adaugă o adresă de email validă
- Nume complet
Notes
- Safety AZ only allows SSO-based login and does not support password-based login for enterprise accounts
- Please ensure that all users who need access to Safety AZ can authenticate using Okta
- Users are automatically provisioned if your license has available seats
Troubleshooting
If you encounter any issues during configuration or login, please contact Safety AZ support at salut@safety-az.com.