# Active Directory Этот внешний аутентификатор обеспечивает доступ пользователям и группам пользователей, принадлежащим Active Directory, к виртуальным рабочим столам или приложениям. ![](/files/WrUnFNjoBY2QAWnSeA83) ### Версия 3.0 Обязательные параметры для настройки аутентификатора Active Directory: * Имя (Name) – имя аутентификатора; * Приоритет (Priority) – приоритет аутентификатора. Чем ниже значение параметра, тем выше аутентификатор будет отображаться в списке аутентификаторов, доступных в окне доступа пользователя. Допускаются отрицательные значения; * Метка (Label) – позволяет пользователям выполнять вход в систему используя этот аутентификатор, без необходимости выбора из перечня доступных. Доступ к форме входа в таком случае осуществляется по прямой ссылке вида HOSTVM-VDI-Server/uds/page/login/label, где label - значение данного поля. Например, если в поле задано значение AD, ссылка будет иметь вид ; * Хост (Host) – IP-адрес или имя сервера AD; * Порт (Port) – порт подключения к серверу AD (389, или 636 при использовании SSL); * Использовать SSL (Use SSL) – если установлено значение «Да», используется SSL-соединение с сервером AD; * Пользователь (Ldap user) – имя пользователя с правами чтения AD в формате: user\@domain; * Пароль (Password) – пароль пользователя; * Тайм-аут (Timeout) – тайм-аут подключения к AD, в секундах; * База (Base) – база поиска (для пользователей и групп) в AD (например dc=example,dc=com). ![](/files/-M6-saMHjRE2da-pwA9L) Нажав кнопку «Проверить» (Test), можно проверить, правильно ли настроено соединение с AD. ### Версия 3.5 **Обязательные параметры** для настройки аутентификатора Active Directory: *Основные (Main)* * Имя (Name) – имя аутентификатора; * Приоритет (Priority) – приоритет аутентификатора. Чем ниже значение параметра, тем выше аутентификатор будет отображаться в списке аутентификаторов, доступных в окне доступа пользователя. Допускаются отрицательные значения; * Метка (Label) – позволяет пользователям выполнять вход в систему используя этот аутентификатор, без необходимости выбора из перечня доступных. Доступ к форме входа в таком случае осуществляется по прямой ссылке вида HOSTVM-VDI-Server/uds/page/login/label, где label - значение данного поля. Например, если в поле задано значение AD, ссылка будет иметь вид ; * Хост (Host) – IP-адрес или имя сервера AD; * Использовать SSL (Use SSL) – если установлено значение «Да», используется SSL-соединение с сервером AD; * Тайм-аут (Timeout) – тайм-аут подключения к AD, в секундах; *Учётные данные (Credentials)* * Имя пользователя (Username) – имя пользователя с правами чтения AD в формате: user\@domain; * Пароль (Password) – пароль пользователя; *Расширенные (Advanced)* * База поиска (Search base) – база поиска (для пользователей и групп) в AD (например dc=example,dc=com). **Дополнительные параметры** для настройки аутентификатора Active Directory: *Расширенные (Advanced)* * Переопределить базу поиска для групп (Override search base for groups) – если задано, переопределяет базу поиска AD для групп (например ou=groups,dc=example,dc=com); * Домен по умолчанию (Default domain) – если задано, этот домен будет добавляться к имени пользователя для входа в систему, когда явно не используется UPN (user\@domain). По умолчанию, если поле не заполнено, используется значение домена учетной записи со вкладки "Учетные данные". Указывается в формате `domain.dom`; * Получить вложенные группы (Fetch Nested Groups) – если включено, поиск членства пользователя будет осуществляться во вложенных группах, в дополнение к тем, в которых он состоит напрямую.\ \ \&#xNAN;*Примечание:* при большом количестве групп в домене и глубоком уровне их вложенности время ожидания ответа от контроллера домена может серьезно увеличиваться, и в некоторых случаях приводить к ошибке аутентификации пользователя. В таких случаях рекомендуется активировать эту настройку совместно с ограничением базы поиска групп (заданием параметра "Переопределить базу поиска для групп"). Нажав кнопку «Проверить» (Test), можно проверить, правильно ли настроено соединение с AD. ### Версия 3.6 **Обязательные параметры** для настройки аутентификатора Active Directory: *Основные (Main)* * Имя (Name) – имя аутентификатора; * Приоритет (Priority) – приоритет аутентификатора. Чем ниже значение параметра, тем выше аутентификатор будет отображаться в списке аутентификаторов, доступных в окне доступа пользователя. Допускаются отрицательные значения; * Метка (Label) – позволяет пользователям выполнять вход в систему используя этот аутентификатор, без необходимости выбора из перечня доступных. Доступ к форме входа в таком случае осуществляется по прямой ссылке вида HOSTVM-VDI-Server/uds/page/login/label, где label - значение данного поля. Например, если в поле задано значение AD, ссылка будет иметь вид ; * Хост (Host) – IP-адрес или имя сервера AD; * Использовать SSL (Use SSL) – если установлено значение «Да», используется SSL-соединение с сервером AD; * Совместимость (Compatibility) - уровень совместимости для аутентификатора Active Directory. *Учётные данные (Credentials)* * Имя пользователя (Username) – имя пользователя с правами чтения AD в формате: user\@domain; * Пароль (Password) – пароль пользователя; *Расширенные (Advanced)* * База поиска (Search base) – база поиска (для пользователей и групп) в AD (например dc=example,dc=com); * Тайм-аут (Timeout) – тайм-аут подключения к AD, в секундах. **Дополнительные параметры** для настройки аутентификатора Active Directory: *Расширенные (Advanced)* * Переопределить базу поиска для групп (Override search base for groups) – если задано, переопределяет базу поиска AD для групп (например ou=groups,dc=example,dc=com); * Домен по умолчанию (Default domain) – если задано, этот домен будет добавляться к имени пользователя для входа в систему, когда явно не используется UPN (user\@domain). По умолчанию, если поле не заполнено, используется значение домена учетной записи со вкладки "Учетные данные". Указывается в формате `domain.dom`; * Получить вложенные группы (Fetch Nested Groups) – если включено, поиск членства пользователя будет осуществляться во вложенных группах, в дополнение к тем, в которых он состоит напрямую.\ \ \&#xNAN;*Примечание:* при большом количестве групп в домене и глубоком уровне их вложенности время ожидания ответа от контроллера домена может серьезно увеличиваться, и в некоторых случаях приводить к ошибке аутентификации пользователя. В таких случаях рекомендуется активировать эту настройку совместно с ограничением базы поиска групп (заданием параметра "Переопределить базу поиска для групп"). * Проверка SSL - проверка SSL сертификата сервера AD; * Сертификат - CA сертификат сервера AD. *МФА (MFA)* * Атрибут MFA - атрибут для извлечения кода МФА; * Провайдер MFA - провайдер МФА, используемый этим аутентификатором. Нажав кнопку «Проверить» (Test), можно проверить, правильно ли настроено соединение с AD. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://kb.pvhostvm.ru/hostvm-vdi/hostvm-vdi-admin-guide/authenticators/active-directory.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.