1. Home
  2. Integrations
  3. How to connect Microsoft Azure with Hector

How to connect Microsoft Azure with Hector

Welcome to this online guide, which will show you how, in a few quick steps, configure Microsoft Azure with Hector. This will allow you to benefit from single sign on functionalities, as well as performing user, city, department and title import into Hector.

1. Connect to your Microsoft Azure account.

You must have administrator privileges in order to add Hector as an authorized App.

2. Primary Domain

Once connected, click on the “Azure Active Directory” link and then copy your Azure Primary Domain, located below, as you will need it later in the guide.

3. App Registrations

Click on the “App registrations” button on the menu and then click on the “Register an application” button.

4. Register an application

  1. Enter a name for the application, we recommend HectorApp.
  2. Provide a redirect URI, we recommend entering your HectorApp URL.
  3. Click on Register

5. App registration completed

  1. Copy the “Application (client) ID” and save for later.
  2. Click on the “View API Permissions” link

6. Permissions

Click on the “Add a permission” button

Click on the “Microsoft Graph” section.

Click on the “Application permissions” section.

Scroll until you find the Directory section and expand using the arrow.

Select the permission “Directory.Read.All” and then click on the “Add permissions” button at the bottom.

Once the permission has been added, it must be consented to.

  1. Validate that the newly added permission is indeed part of the permission list.
  2. Click on the “Grant admin consent for …………….” button

Once this button is clicked, confirm the consent using the “Yes” button at the top of the screen.

A confirmation message should indicate that all permissions have been added and consented by an administrator.

For Hector to perform at its best, the permissions granted should be similar to the image below:

7. Public App

Make the application public, in order for Hector to connect to it.

  1. Click on the Authentication section
  2. Scroll to the bottom and in the “Advanced Settings”, click on “Yes” to set the application as a public client.
  3. Click on the Save button

8. Secret Key

Click on the “Certificates & secrets” section

Next click on the “+ New client secret” button

  1. Enter “HectorApp” as a description
  2. Enter Never, or another expiration delay
  3. Click on the Add button
  1. Copy the secret value and save for later

You have completed the Azure portion of the setup. Next step is to access your Hector instance as an administrator

9. Hector Setup for Azure Authentication

  1. Connect to your Hector instance as an administrator.
  2. Navigate to the “Settings” menu, and then click on “Security”.
  3. Once inside, click on the “Azure Active Directory” option in order to display the necessary fields to configure authentication using Azure.

4. Copy paste the following fields, copied from earlier in the Azure configuration.

  • Primary domain
  • Client Id
  • Secret

Congratulations, your users can now begin to sign on to Hector using their Azure credentials.

10. Hector Setup for User Synchronization

If you would like to perform daily synchronization of all your users with Hector, you must fill in the following fields and make sure that the “Import Users” checkbox is checked. If this step is not done, users will not be synchronized from Azure.

  • Administrators Group
    • Will grant Administrator privileges to members of this group
  • Staff Group
    • Will grant Staff privileges to members of this group
  • Limited Staff Group
    • Will grant Limited Staff privileges to membres of this group
  • Users Group
    • Will grant User privileges to members of this group

Finally, you may also select to import cities, states, countries and departments from your Azure Active Directory by checking the options.

Updated on April 20, 2022

Was this article helpful?

Related Articles