> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Synchronize Users from Active Directory

<Badge icon="arrow-left" color="gray">[Back to Admin Console](/ai-for-service/administration/overview)</Badge>

Configure Kore.ai to synchronize with your organization's LDAP Active Directory to enroll users automatically. You can sync user profiles, set up scheduled syncs, and define inclusion/exclusion rules.

Kore.ai syncs user data (name, department, title, phone, location, status) from your AD. Your Active Directory is never modified during sync. Deactivated AD users are automatically deactivated in Kore.ai during the next scheduled sync.

***

## Prerequisites

* Administrative access to read and execute actions on your LDAP server
* Familiarity with LDAP queries and LDAP server administration
* Microsoft Active Directory LDAP Server

***

## Configuration

1. In the **Enrollment** module, select **Directory Sync**.
2. Select **Cloud-Based Connector**.
3. Under **Configure**, select **Configure**.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img1.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=221c88f3ab2387b40dc9e8bc9cd8e518" alt="Cloud Based Connector - Configure" width="1366" height="768" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img1.png" />

The **Configure Synchronization with your Company Directory** wizard opens.

<Note>If your bot was built before platform v7.3, you may see an **Upgrade** option. Configuring without upgrading disables access to AD sub-groups, custom field mapping, and inclusion rules. The older version will be deprecated in upcoming releases.</Note>

### Connection Tab

<img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img2.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=bba90f9a40990a9624ee5b26ae3edf3e" alt="Connection Tab" width="1181" height="557" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img2.png" />

| Field               | Description                                                           |
| ------------------- | --------------------------------------------------------------------- |
| **Host Name**       | Domain host name or IP (for example, `www.iana.org` or `10.12.6.151`) |
| **Server Port**     | Port number for the domain host (for example, `10042`)                |
| **Base DN**         | Server location for users and groups (for example, `dc=kore,dc=com`)  |
| **User ID**         | Username for authentication to the domain controller                  |
| **Password**        | Password for authentication to the domain controller                  |
| **SSL**             | Enable for HTTPS connections                                          |
| **Test Connection** | Validate the host and authentication settings                         |

Select **Save and next** to continue.

### Organizational Units Tab (Optional)

Define which Org Units to import. Groups and sub-groups from selected OUs are synced, maintaining the AD hierarchy.

Options:

* Import all Organization Units
* Don't import any units
* Import specific units

Select **Save and next** to continue.

### Distribution Lists Tab (Optional)

Select **Import Distribution Lists from Active Directory** if needed.

### Users Tab

Configure the user attributes and rules to import.

**User Attributes sub-tab:**

* Use **Default** mapping (Kore.ai profile fields to LDAP attributes)
* Or create **Custom** mappings with attribute names and values

**Inclusion Rules sub-tab:**
Sync only users who match defined criteria. Use LDAP filter syntax. [Learn more about LDAP filters](https://social.technet.microsoft.com/wiki/contents/articles/5392.active-directory-ldap-syntax-filters.aspx).

**Exclusion Rules sub-tab:**
Limit imported user records using defined rules.

<img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img3.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=f6a1ba41459e4e26db46f2acc1990589" alt="Exclusion Rules" width="945" height="481" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img3.png" />

### Kore.ai Exclusions Tab (Optional)

Prevent Active Directory from overwriting specific users, distribution lists, or organizational groups in Kore.ai.

<img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img4.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=d8f31577ea3d8148b91d31dbd46f2fa0" alt="Define Exclusions" width="943" height="439" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img4.png" />

### Schedule Tab

Configure the automatic synchronization schedule.

<img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img5.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=32c5c6303275e4f5f9355759294b35b2" alt="Synchronization Schedule" width="874" height="632" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img5.png" />

1. Enable **Enable Synchronization**.
2. Set **Synchronization Frequency**:

   | Option      | Description                                     |
   | ----------- | ----------------------------------------------- |
   | **Daily**   | Set start date and time                         |
   | **Weekly**  | Set day of week and start date/time             |
   | **Monthly** | Set day of month and start date/time            |
   | **Other**   | Set number of days or weeks and start date/time |

Select **Save** to save settings and close the wizard.

***

## Deleted Users

When a user is deleted or marked deleted in AD, the following applies in Kore.ai:

* The user is deleted from the platform for that specific account.
* The user record is retained in the database for audit and cross-reference.
* Login attempts are blocked.
* If the user belongs to multiple accounts, they retain access to other accounts where they are still active.
* Users can't be deleted if they are a Bot Owner or Account Owner — these appear in AD Sync logs with a reason.

***

## Manual Sync

To trigger a sync immediately:

1. In **Enrollment > Directory Sync**, go to the **Current Settings** section.
2. Select **Run Now**.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img6.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=d9d5f3acaf6ce8402a505b893cb25a8b" alt="Run Manual Sync" width="1238" height="603" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img6.png" />

The *Directory Synchronization is in-progress* message appears at the top.

***

## View Sync Report

To view the last sync results:

1. In **Enrollment > Directory Sync**, select the **here** link in the Current Settings section.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img7.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=ff1a67eec14a51e5620d3120e3ed5c4f" alt="View Last Run Report" width="1028" height="574" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img7.png" />

2. The **Report on Active Directory Sync** dialog opens.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img8.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=6cbe586350863fd6cce114eec73e789e" alt="Active Directory Sync Report" width="1806" height="1126" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img8.png" />

***

## View Sync History

To view all historical sync operations:

1. In **Enrollment > Directory Sync**, select **Sync History** in the Current Settings section.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img9.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=de1532ffea5d79f3495ee0c1aaf6fef9" alt="Sync History" width="1238" height="603" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img9.png" />

2. In the **History of Active Directory Synchronization Runs** dialog, select **Sync Results** in the **Report** column for the run you want to view.

   <img src="https://mintcdn.com/koreai/mKxGC8UPdZt2RNJG/ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img10.png?fit=max&auto=format&n=mKxGC8UPdZt2RNJG&q=85&s=3e73448aafcee62f05904a6a5f1226c0" alt="View Sync Report" width="1532" height="1254" data-path="ai-for-service/administration/enrollment/images/synchronizing-users-from-active-directory-img10.png" />