---
title: Lab Tooling settings (admin)
slug: tv-toolbox/lab-tooling-settings-admin
icon: {"lucideIcon":"Settings2"}
createdAt: 2026-10-22T12:16:21.293Z
---

Besides the Microsoft Entra ID connection, Lab Tooling has three groups of settings that control how lab users are created, synchronised, and cleaned up. All of them are on the same page: **Administration > Configurations > Lab Tooling**.

:::hint{type="info"}
This guide is for admins. You need the **View Admin Configurations** permission to see the settings and **Manage Admin Configurations** to change them.
:::

:::hint{type="warning"}
Lab Users needs the **User Group settings** to be saved. Until then, the app shows "User Group settings not configured" and blocks the related actions.
:::

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

***

## User Group settings

These settings define the defaults for every lab user group that is created.

1. Go to **Administration > Configurations > Lab Tooling**.
2. Open the **User Group settings** section.
3. **Password settings**: Te password policy. This will be enforced whenever lab user passwords are generated.
   1. Click on the :FontAwesome[]{icon="fa-solid fa-pencil"}-icon to expand the inputs
   2. You can set a **Minimum length**, Maximum Length, and choose if you want to enforce the use of **numbers**, **special characters**, **uppercase letters**, **lowercase letters**.
4. **Default disabled password**: Whenever a user group gets disabled, the password is automatically changed to this password. This is not set by default, but is required.
   *This prevents a participants from being able to access the environment again after the users get re-enabled.*
5. **Default display name**: This is the default display name for lab users. This will be followed by the user number and group identified. It's defaulted to `Lab user`, but can be changed.
6. Select **Save**.

:::hint{type="danger"}
The **Default disabled password** is <font color="#ff0000">**required**</font>. Make sure to set this before giving users access to this feature.
:::

:::hint{type="info"}
Changing these settings does not change existing groups. The new rules only apply to groups and passwords that are created or updated afterwards.
:::

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/hjtJpqIIEq7vkfl48rp8j_image.png" size="40" isUploading="false" width="799" height="1707" darkWidth="799" darkHeight="1707" showCaption="false"}

***

## Entra > Adobe Sync

Lab users are created in Microsoft Entra ID and passed on to Adobe by a scheduled synchronisation. This section shows how that synchronisation is set up.

1. Go to **Administration > Configurations > Lab Tooling**.
2. Open the **Entra > Adobe Sync** section.
3. **Sync lockout (minutes)**: This controls how much time needs to be between syncs (manual or scheduled). It defaults to `5 minutes`, meaning after a sync a user has to wait at least 5 minutes to start another sync.
4. **Last Manual Sync**: This display when the last sync happened and whether this was triggered manually or through the Entra ID Scheduler (every 40 minutes)

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/krWGcGXAGlCMpx4LR0i1x_image.png" size="40" isUploading="false" width="800" height="851" darkWidth="800" darkHeight="851" showCaption="false"}

### What this means for lab teams

- Changes are visible in Entra ID straight away, but participants can only sign in once the change has reached Adobe.
- Users with edit access can request an immediate sync with **Sync Now** on the Lab Users tab. This normally takes a couple of minutes.

:::hint{type="info"}
Whenever a user starts a manual **Sync**, the Entra ID Scheduler is pushed to 40 minutes after the manual sync.
:::

***

## IMS Directory Cleanup

When a group is disabled or its users are removed, the users are removed from Adobe IMS on the next sync. However, Adobe IMS keeps a trace of these users in the Directory so that it can connect these users back up if they ever get recreated. In our instances this is unwanted behaviour and can accumulate a lot of stale records over time. The IMS Directory Cleanup removes these leftovers so the directory does not fill up over time.

1. Go to **Administration > Configurations > Lab Tooling**.
2. Open the **Entra > Adobe Sync** section.
3. **Automatic cleanup**: Enabling this will make users trigger the cleanup automatically when they open the "Lab Users" and a cleanup is due. This is set to `disabled` by default and can only be turned on if the Microsoft Entra ID API has been fully set up.
4. **Cleanup interval**: This controls the days between automatic cleanups. Default is set to `7 days`, meaning if a user opens the "Lab Users" page and the last cleanup was more than 7 days ago it will trigger a cleanup.
   *This process is invisible from the front-end and runs entirely on the server.*
5. **Cooldown after failure (hours)**: This controls the time between cleanups if the last cleanup failed. Default is set to `1 hour`, meaning if the cleanup fails the next cleanup cannot be triggered for 1 hour.
   *For example: A cleanup can fail if the connection to Adobe IMS gets interrupted*
6. Select **Save**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/YaINWIRSs1JlsJfEfXjFf_image.png" size="40" isUploading="false" width="800" height="1369" darkWidth="800" darkHeight="1369" showCaption="false"}

### Manual Cleanup

You can run a **Manual Cleanup** to run the cleanup right away, without waiting for the interval. This is useful for the initial cleanup as your tenant might have accumulated a lot of stale users.&#x20;

1. Click **Manual Cleanup**.
2. You'll see a list of **Users to be removed**.
3. Click **Remove X users**.

::Image[]{src="https://api.archbee.com/api/optimize/1Jp0iolWv35Z_mkI7oUiT/Zw_1gVg2w2wsTV66bZWQz_image.png" size="40" isUploading="false" width="1283" height="1188" darkWidth="1283" darkHeight="1188" showCaption="false"}

:::hint{type="info"}
This process only deletes **disabled** users. If a disabled user would ever get re-enabled in Entra ID the next sync will just recreate the user in Adobe IMS.
:::

***

## Troubleshooting

| Problem                                                                | What to do                                                                                                                  |
| ---------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| "User Group settings not configured" appears on the Lab Users tab      | Save the password policy, default disabled password, and default user display name.                                         |
| A password is rejected when creating or changing a group               | Compare it with the password policy in the User Group settings.                                                             |
| The sync schedule shows 40 minutes, but Entra ID uses another interval | The app could not read the interval from Entra ID. Check the Entra ID connection with **Test Connection**.                  |
| The automatic cleanup does not run                                     | It only runs when someone opens the Lab Users tab and a cleanup is due. Check that it is turned on and the interval is set. |
| The settings cannot be changed                                         | You may only have **View Admin Configurations**. Ask for **Manage Admin Configurations**.                                   |

