How to: Integrate with Okta
*Ensure that this process is carried out by an Administrator.
- In the Okta Admin Console go to Applications and click "Browse App Catalog."
- Search for Hellotracks.
- Click "Add Integration."
- Click "Done."
- You can assign the users and groups that will have access to the application in the Assignments tab.
- Retrieve Client ID and Client Secret from "Sign On" tab.
- Find your Okta domain / URL from upper right corner of the Okta Admin Console.
- In Hellotracks, go to "API & Integrations." In the Single Sign-on section, choose Okta and enter the Client ID and client Secret from above and set the Okta domain as the URL.
Optional: Life Cycle Management (SCIM)
To set up user provisioning, please follow instructions in Lifecycle Management with Okta (SCIM).
All done.
Now users are ready to use Okta to SSO in Hellotracks. ✅
For users to log in via SSO:
WEB
- Go to https://live.hellotracks.com/login and click the Single Sign-On button on the bottom (this will navigate users to the SSO page).
- Enter either an existing Hellotracks username or the company code for users that do not yet exist in Hellotracks.
MOBILE
- Click Log in.
- Click "Single Sign-On."
- Enter either an existing Hellotracks username or the company code for users that do not yet exist in Hellotracks.
After a successful SSO log in of a user that doest not yet exist in Hellotracks, the user will automatically be created and the Worker role will be assigned.
To get into the SSO login page of your identity provider, you can either use an existing username in Hellotracks or set the code seen in the SSO configuration section as the username to get forwarded to the SSO login page of your identity provider.