How to: Integrate with Microsoft Azure Active Directory (AD)

This guide explains how to set up Single Sign-On (SSO) integration with Microsoft Azure Active Directory (AD) for your Hellotracks account.

Step 1: Log into Microsoft Azure and open Default Directory.

Step 2: In the "+Add" menu, click "App registration."

Step 3: Register your Hellotracks application.

• Enter the information as it is presented in the screenshot below:

1. Name: e.g. Hellotracks
2. Redirect URL: Choose "Web" and set https://auth.hellotracks.com/v1/callback.
3. Click "Register."

Step 4: Create a new Client Secret.

• After creating the Application, go to "Add a certificate or Secret" or in "Certificates & secrets,"
• Click "+ New client secret".
• Then, click "Add."

Step 5: Keep a copy of your secret Value (not Secret ID) as you will need this for Hellotracks.

Step 6: Assign Users and Groups to the Hellotracks App.

• Only users assigned to this app will have access to Hellotracks via SSO.
• You can assign users to the app by clicking the link below "Managed application in local directory" on the app overview page.

Configure the app within Hellotracks

Step 7: In Hellotracks, go to Settings and select "API & Integrations."

Step 8: In the Single Sign-On (SSO) section, click "Setup SSO configuration."

Step 9: Fill in the needed details.

• Select Azure AD as the Identity Provider.

• Enter Tenant ID and Client ID which can be retrieved from the application overview page in Azure AD.

• Enter the Client Secret (the Value you copied earlier in Step 5) into the corresponding field.

Step 12: Click Save.

For users to log in via SSO:

WEB

Step 1: 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).

Step 2: Enter either an existing Hellotracks username or the company code for users that do not yet exist in Hellotracks.

MOBILE

Step 1: Click "Log in."

Step 2: Click "Single Sign on."

Step 3: Enter either an existing Hellotracks username or the company code for users that do not yet exist in Hellotracks.