---
title: Set up integration (admin)
slug: tv-toolbox/set-up-integration-admin
icon: {"lucideIcon":"Wifi"}
createdAt: 2026-10-22T10:00:12.600Z
---

*Lab Users are created in Microsoft Entra ID, so we need to establish a connection to your Entra ID tenant. This guide shows how to create the API user (an app registration) in Entra ID and how to add it to the Toolbox.*

:::hint{type="warning"}
This guide is for admins. You need the **Manage Admin Configurations** permission, and an Entra ID role that can create app registrations and grant admin consent.
:::



## Before you start

- Access to the **Microsoft Entra admin center** for the tenant where the lab users are created.
- A role that allows you to register applications and grant admin consent for API permissions.
- A safe place to store the client secret, because it is shown only once.

***

## Step 1: Create the API user in Entra ID

1. Sign in to the [Microsoft Entra admin center](https://entra.microsoft.com/auth/login/).
2. Navigate to **Entra ID > App registrations**.
3. Select **New registration**.
4. Set the **Name** to `TV Lab Tooling`.
5. Under **Supported account types**, select `Single tenant only - [tenant name]`.
6. Leave the redirect URI empty and select **Register**.

![](https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/7XQgAI--8aRM-Cqecguaq_image.png)

***

## Step 2: Add the API permissions

1. Open the new app registration and go to **API permissions**.
2. Select **Add a permission > Microsoft Graph > Application permissions**.
3. Add the permissions listed below.
   - **Application.Read.All**
     *To find Adobe app, read its roles and secret expiry*
   - **AppRoleAssignment.ReadWrite.All**
     *To assign groups to the Adobe app*
   - **AuditLog.Read.All**
     *To read provisioning logs*
   - **Group.ReadWrite.All**
     *To create, edit, delete groups*
   - **GroupMember.ReadWrite.All**
     *To add and remove group members*
   - **Organization.Read.All**
     *To read tenant info (verified domains)*
   - **Synchronization.Read.All**
     *To read sync job status*
   - **Synchronization.ReadWrite.All**
     *To start, restart and manage sync jobs*
   - **User-PasswordProfile.ReadWrite.All**
     *To reset user passwords*
   - **User.ReadWrite.All**
     *To create, edit, enable, disable, delete users*
4. After you added all permissions you'll notice the overview Status-column will say these permissions require admin consent. Click **Grant admin consent for \[tenant name]&#x20;**&#x20;and confirm.

![](https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/bqV_j47alCr1mO3LDxi0h_image.png)

:::hint{type="danger"}
Application permissions without admin consent do not work. Check that every permission shows a green "Granted" status.
:::

***

## Step 3: Create a client secret

1. In the app registration, go to **Certificates & secrets**.
2. Select **New client secret**.
   1. Set the **Description** to `TV Lab Tooling API Integration`.
   2. Set **Expires** to `730 days (24 months)`.
3. Select **Add**.
4. Copy the **Value** and **Secret ID&#x20;**&#x74;o a notepad.

![](https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/v4Wam_gOMRss-uQTbA_1O_image.png)

:::hint{type="warning"}
Make sure to copy both the **Value** and the **Secret ID**. The value will become hidden after you leave the page. If you lose it, you'll have to create a new secret.
:::

***

## Step 4: Find the required inputs

1. Let's add more values to the notepad.

| Value             | Where to find it                                                                |
| ----------------- | ------------------------------------------------------------------------------- |
| **Tenant ID**     | **Entra ID > App registrations > TV Lab Tooling > Directory (tenant ID**        |
| **Client ID**     | **Entra ID > App registrations > TV Lab Tooling >** **Application (client) ID** |
| **Secret ID**     | Added in step 3                                                                 |
| **Client secret** | Added in step 3                                                                 |

![](https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/9N61RPEiIcxTaZP_IeFZD_image.png)

***

## Step 5: Add the integration

1. In the App, navigate to **Administration > Configurations > Lab Tooling**.
2. Find the Microsoft Entra ID section.
3. &#x20;Fill out the fields **Tenant ID**, **Client ID**, **Secret ID** and **Client Secret** you looked up beforehand.
4. Set **Graph Base URL** to `https://graph.microsoft.com/v1.0`.
5. You can't save these setting unless the connection works. Click **Test Connection**.
6. After a brief load, assuming the input was correct, the **Derived Values** will show up.
7. Click **Save**.

![](https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/zYvHyyaqskxTYpj0OZF0G_image.png)

:::hint{type="info"}
**Test Connection** uses the given credentials to sign in to Entra ID and runs a simple check with the permissions you granted. It does not create or change any users. It's a simple safety precaution to prevent you from saving invalid credentials.
:::

***

## Next steps

After the connection works, finish the remaining Lab Tooling settings on the same page: the password policy, the default disabled password, and the default user display name. Lab Users needs all of them.
