How to Integrate with Okta
This guide explains how to set up Single Sign-On (SSO) integration with Okta for your Hellotracks Business account.
Ensure that this process is carried out by an Administrator.
Step 1: In the Okta Admin Console, go to Applications and click Browse App Catalog.

Step 2: Search for Hellotracks.

Step 3: Click Add Integration.

Step 4: Click Done.

Step 5: Assign users and groups that will have access to the application in the Assignments tab.

Step 6: Retrieve your Client ID and Client secret from the Sign On tab.

Step 7: Copy your Okta domain (for example, https://your-domain.okta.com). You find it in the upper right corner of the Okta Admin Console.

Configure the app within Hellotracks
Step 8: In Hellotracks, go to Settings and select API & Integrations.

Step 9: Under Single Sign-On (SSO), click Set up SSO configuration.

Step 10: Under Select identity provider, choose Okta. Then fill in the fields:
- Enter client ID: the Client ID from Step 6
- Client secret (remains hidden for safety reasons): the Client secret from Step 6
- Enter redirect URL: your Okta domain from Step 7 (for example, https://your-domain.okta.com)

Step 11: Click Save.

Step 12: Under Single Sign-On (SSO), a Notes box now shows Link to SSO login page. Click the copy button next to it and send the link to your users.
The link opens your Okta login page directly. Users who don't have a Hellotracks account yet need this link for their first login: Hellotracks then creates their account with the Worker role, and their Okta email becomes their username.
Optional: Life Cycle Management (SCIM)
To set up user provisioning, please follow instructions in How to Manage User Lifecycle with Okta (SCIM).
All done. Now users are ready to use Okta to log in to Hellotracks.
For users to log in via SSO:
FIRST LOGIN (NEW USERS)
Open the Link to SSO login page that your admin sent you and log in with Okta. This works in any browser, also on your phone. Hellotracks creates your account, with your Okta email as username. After that, you can log in on the web and in the app as described below.
WEB
Step 1: Go to https://live.hellotracks.com/login and click the Single Sign-On (SSO) button at the bottom.

Step 2: In Username or email, enter your Hellotracks username and click Log in. Your Okta login page opens.

MOBILE
Step 1: Open the Hellotracks app and tap Log in.
Step 2: In Email or username, enter your Hellotracks username and tap Continue.
Step 3: Tap Log in with single sign-on. Your Okta login page opens.
The Log in with single sign-on button only appears for accounts of a company with SSO set up. Logging in with a password stays possible on the same screen.