Documentation
Powered by

Reconsent a Service Account Connector for HXA.io Door Connect (Microsoft Teams)

Overview

If the Microsoft Teams connector for HXA.io Door Connect requires renewed permissions, a reconsent process must be performed.

You can identify this directly in the Connectors page of the HXA.io Portal.

If a reconsent is required, the connector status will display a red circular arrow icon. Click this icon to start the reconsent process.

Step 1 – Open the Connector Reconsent

Navigate to:

HXA.io Portal → Connectors

Locate the Microsoft Teams connector for HXA.io Door Connect.

If reconsent is required, you will see:

  • A red circular arrow icon
  • Connector status indicating that renewed consent is necessary

Click the icon to continue.

Step 2 – Initial Consent Information

After clicking the reconsent icon, HXA.io will display the following information:

To add a Service Account Connector, follow these steps:

First, sign in with a Microsoft administrator account to grant consent on behalf of your organization to our application. This initial login is required to authorize access.

After consent is granted, we will display a login code. Enter this code at the Microsoft login URL and sign in with the account you want to use as the service account.

Click continue to open the Microsoft authentication window.

Step 3 – Microsoft Login

A Microsoft login window will open from:

https://login.microsoftonline.com/

At this step:

  • Use the account that was originally used to grant the first consent for the application
  • This is typically an administrator or Azure application administrator account

Step 4 – Admin Approval (if required)

If the selected account does not have sufficient administrator rights, Microsoft will display an elevation request.

Microsoft message example:

Need admin approval
HXA.io Door Connect needs permission to access resources in your organization that only an admin can grant. Please ask an admin to grant permission to this app before you can use it.

Have an admin account? Sign in with that account.

In this case:

  • Sign in using an administrator account
  • The account must have permission to:
    • Grant tenant-wide consent
    • Register or approve enterprise applications in Microsoft Entra ID (Azure AD)

Step 5 – Grant Permissions

Microsoft will now display the permissions requested by HXA.io Door Connect.

Example permissions:

  • Send channel messages
  • Read all groups
  • Read the names and descriptions of teams
  • Read the names and descriptions of channels
  • Read all users' basic profiles
  • Read user channel messages
  • Maintain access to data you have given it access to
  • View users' basic profile

You will also see the option:

Consent on behalf of your organization

Important

You must:

  • Enable the checkbox:
    • Consent on behalf of your organization
  • Then click:
    • Accept

This grants the required permissions tenant-wide.

Step 6 – Device Login Information

After successful admin consent, HXA.io will display a device login information window.

Example:

Info
Please enter the device code "" at
https://login.microsoft.com/device
and login with the account you wish to use as the service account.

At this point:

  1. Copy the displayed device code

  2. Open:

    https://login.microsoft.com/device

  3. Paste the device code

Step 7 – Authenticate the Service Account

Microsoft will now display:

Enter code to allow access
Once you enter the code displayed on your app or device, it will have access to your account.

Continue with:

  • The account that should be used as the actual HXA.io Door Connect service account
  • This account does not need to be the admin account
  • It should be the dedicated operational Teams service account

Click:

Continue

Step 8 – Confirm the Application Access

Microsoft will ask:

Are you trying to sign in to HXA.io Door Connect?
Only continue if you downloaded the app from a store or website that you trust.

Click:

Continue

Step 9 – Completion

After successful authentication, Microsoft will display:

HXA.io Door Connect
You have signed in to the HXA.io Door Connect application on your device. You may now close this window.

The reconsent process is now completed successfully.

Result

The Microsoft Teams service account connector is now:

  • Reauthorized
  • Connected again to Microsoft Teams
  • Ready for operation within HXA.io Door Connect

The connector status in the HXA.io Portal should now return to a healthy state.