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

Log into Microsoft Azure and open Default Directory.

• In the "+Add" menu, click "App registration"

  

Register Hellotracks application

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

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

Create a new Client Secret

1. After creating the Application, enter “Add a certificate or Secret” or in "Certificates & secrets", click "+ New client secret"
2. Click "Add"

Keep a copy of your secret Value. (not Secret ID)

Assign Users and Groups to the Hellotracks App

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

Configure the app within Hellotracks

1. Choose "API & Integrations" in the main menu
2. In the Single Sign-On section, click "Setup SSO configuration"
3. Select "Azure AD" as the Identity Provider

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

   

5. Enter Client Secret in Hellotracks which you already copied before, Make sure it's the Value.

   

   

All done.

Now users are ready to use Azure AD for 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.