Setting up Microsoft authentication

You can allow users to log in to Haiilo with their Microsoft credentials. To enable the login, you need to complete steps both in Microsoft Entra ID and in Haiilo's Administration.

Set up an app registration in Microsoft

You need admin rights in your Microsoft Entra ID account to generate and obtain the required Client ID and Secret.

Create an app

  1. Log in to the Microsoft Azure Platform.
  2. Go to Microsoft Entra ID > App registrations > New registration
  3. Give your app a name, e.g., Haiilo
  4. For Supported account types, choose Accounts in any organizational directory (Any Microsoft Entra ID tenant - Multitenant)
  5. Select Register
  6. On the app Overview page, copy and save the Application (client) ID and Directory (tenant) ID for later use

App registration overview page in Microsoft Azure.png

Create a Client Secret and define API permissions

  1. Create Client Secret
    1. Go to Certificates & secrets > Client secrets
    2. Select New client secret
    3. Enter a description and choose when the secret expires.
      • After a secret expires, you need to generate a new secret and update it in Haiilo for the connection to remain valid. We recommend setting up a reminder to renew the secret before it expires.
    4. Select Add
    5. Copy the secret Value for later use. It is recommended to store the secret in a secure location.
  2. Define API permissions
    1. Go to API permissions
    2. Select Add a permission > Microsoft Graph > Delegated permissions
    3. Add the following API permissions:
      • offline_access
      • openid
      • User.Read
      • If you will also be using a Microsoft Graph user directory, the required permissions for the directory sync can be granted at the same time or added later. You can find these permissions in User directory: Microsoft Graph.
      • If you will also be using the Microsoft add-on features, the required permissions for the add-on can be granted at the same time or added later. You can find these permissions in Activating the Microsoft add-on features.
    4. Select Grant admin consent for app_name for the added permissions and ensure the status for all permissions is marked Granted for your_tenant.

API permissions for Microsoft authentication.png

Keep the browser tab for Microsoft Entra ID open, so you can add the request URL after setting up the connection in Haiilo.

Set up a new authentication provider in Haiilo

You need "Manage authentication providers" permission to set up an authentication provider in Haiilo.

  1. In Haiilo, go to Administration Authentication
  2. Select Create authentication provider
  3. Enter a name. The name is displayed to users on the login screen after "Authenticate with".
  4. Select type OpenID Connect
  5. Check Active. You can also leave it unactivated for now and activate it only later when the setup is fully completed.
  6. Decide if you want to use automatic login, which automatically redirects to the identity provider after 3 seconds.
  7. Decide whether this authentication provider sends session emails for new logins.
  8. Select a preset:
    • Microsoft 365: Select if you're only using the basic Microsoft integration features
    • Microsoft 365 + Integration: Select if you're using the basic and add-on Microsoft integration features.
  9. Input the Application (client) ID that you copied from Microsoft Entra ID into the Client ID field
  10. Input the Client Secret Value that you copied from Microsoft Entra ID into the Client Secret field
  11. Input the Directory (tenant) ID that you copied from Microsoft Entra ID into the Tenant ID field
  12. We recommend keeping the preset fields untouched.
  13. Select Save to create the authentication provider
  14. Select Edit on the newly created provider
  15. Copy the Redirect URL that appears at the bottom of the setup page

Authentication provider redirect URL.png

Update Redirect URL in Entra ID

After configuring the authentication provider in Haiilo, you can add the redirect URL in Microsoft Entra ID.

  1. In Microsoft Entra ID, select the app you created earlier > Authentication
  2. Select Add a platform > Web
  3. Enter the copied redirect URL from Haiilo in the Redirect URIs field
  4. Select Configure

Now, if the authentication provider is activated in Haiilo and your users are synced from Microsoft, they can log in to your platform with their Microsoft credentials.

authentication microsoft.png

Was this article helpful?