---
title: "Active Directory User Directories"
slug: "active-directory-user-directories"
updated: 2024-01-17T12:56:31Z
published: 2024-01-17T12:56:31Z
canonical: "help.mail-and-deploy.com/active-directory-user-directories"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://help.mail-and-deploy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Active Directory User Directories

### General

This type of user directory synchronizes [Users](/version340/docs/users) and [User Groups](/version340/docs/user-groups) with an active directory.

          NOTE

          

This type of user directory is not available in the SaaS version of Mail & Deploy.

### Properties

Active Directory user directories have the following properties:

| Name | Description |
| --- | --- |
| Name | The name of the user directory; this is a free text you can assign. |
| Type | *Machine*. When selecting this option, the local user and user group directory of the computer Mail & Deploy is installed on is used for synchronization. *Domain*. When selecting this option, the active directory of a domain controller will be used for synchronization. |
| Host | The host name or IP address of the LDAP server. This property is only applicable if the property *Type* is set to *Domain*. |
| Port | The port of the LDAP server (default is 389). This property is only applicable if the property *Type* is set to *Domain*. |
| Container | An LDAP query string that defines the root container to which Mail & Deploy shall connect when synchronizing with that active directory. It is strongly recommended to be used, especially if you connect to a large active directory, to reduce the time to synchronize with that active directory. This property is only applicable if the property *Type* is set to *Domain*. |
| Use Credentials | When disabled the connection to the LDAP server will the established using the Service Account for authentication; when enabled, you can specify credentials to use for authentication. This property is only applicable if the property *Type* is set to *Domain*. |
| Type | *Custom*. A custom username and password combination will be used to authenticate against the LDAP server. *Windows*. A windows account will be used to authenticate against the LDAP server. This property is only applicable if the property *Type* is set to Domain and the property *Use Credentials* is enabled. |
| Username | The username to use to authenticate against the LDAP server. This property is only applicable if the property *Type* is set to *Domain* and the property *Use Credentials* is enabled. |
| Password | The password to use to authenticate against the LDAP server. This property is only applicable if the property *Type* is set to *Domain* and the property *Use Credentials* is enabled. |

You can test the connection by clicking the *Test Connection* button. #### User Group Queries Every active directory user directory can have one or more user group queries to define which user groups within the actvice directory to synchronize.

          NOTE

          

Only active directory user groups for which a user group query exists will be synchronized.

User group queries have the following properties:

| Name | Description |
| --- | --- |
| Name | The name of the user group within the active directory or a regular expression matching the names of user groups within the active directory (depending on the *Matching Method* property). |
| Matching Method | *Exact Match*. When selecting this option only the active directory user group whose name exactly matches the *Name* property will be synchronized. *Regular Expression*. When selecting this option all active directory user groups whose names match the regular expression contained in the *Name* property of this query will be synchronized. |
| Members Type | The user type to assign to [Users](/version340/docs/users) synchronized with the active directory user group. If a user belongs to multiple queried user groups in the user directory, the user type with the highest permissions will be assigned to that user. |
| Default Language | The default language to assign to [Users](/version340/docs/users) synchronized with the active directory user group unless the active directory user has a preferred language set in the active directory. |
| Time Zone | The time zone to assign to [Users](/version340/docs/users) synchronized with the active directory user group. |
| Culture | The culture to assign to [Users](/version340/docs/users) synchronized with the active directory user group. |