13 октября 2026
ID 221429
Настройка соединения KUMA с Active Directory
Вы можете подключиться только к одному домену Active Directory. Для этого требуется настроить соединение с контроллером домена.
Чтобы настроить соединение с контроллером домена Active Directory:
- В веб-интерфейсе решения выберите раздел Параметры → Доступ → Доменная аутентификация.
- В раскрывающемся списке Тип аутентификации выберите AD/ADFS.
- В блоке параметров Active Directory (AD) включите переключатель Состояние.
- В поле База поиска (Base DN) введите
DistinguishedNameкорневой записи для поиска групп доступа в службе каталогов Active Directory. - В поле URL введите адрес контроллера домена в формате
<hostname или IP-адрес сервера>:<порт>.Вы можете ввести через запятую адреса нескольких серверов с контроллерами домена на случай, если один из них будет недоступен. Все указанные серверы должны находиться в одном домене.
- Если вы хотите использовать TLS-шифрование для соединения с контроллером домена, в поле Режим TLS выберите один из следующих вариантов:
- LDAPS.
При использовании LDAPS сразу устанавливается шифрованное соединение по порту 636.
- StartTLS.
При использовании команды STARTTLS сначала устанавливается незащищенное соединение по порту 389, а затем отправляется запрос на шифрование. Если команда STARTTLS завершается с ошибкой, соединение обрывается.
Убедитесь, что порт 389 открыт. В противном случае, соединение с контроллером домена будет невозможно.
- Незащищенный.
При использовании шифрованного соединения невозможно указать IP-адрес в качестве URL.
- LDAPS.
- Если на предыдущем шаге вы включили TLS-шифрование, в раскрывающемся списке Секрет выберите ранее созданный сертификат шифрования или добавьте новый сертификат шифрования с помощью пункта Создать:
- В окне Создание секрета в поле Название введите название секрета, которое будет отображаться в списке после сохранения.
- Нажмите на кнопку Загрузить сертификат.
- Укажите путь к ранее созданному сертификату шифрования и нажмите на кнопку Открыть.
- Нажмите на кнопку Создать.
Секрет будет загружен и станет доступен для выбора в раскрывающемся списке Секрет.
- В поле Время ожидания (сек.) укажите, сколько времени требуется ожидать ответа от сервера контроллера домена. По умолчанию указано значение 0.
Если в поле URL указано несколько адресов, то решение будет ждать ответа от первого сервера указанное количество секунд. Если за это время ответ не будет получен, решение обратится к следующему указанному серверу. Если ни один из указанных серверов не ответит в течение заданного времени, подключение будет прервано с ошибкой.
- В поле Проверка соединения нажмите на кнопку Тест, чтобы проверить соединение с контроллером домена.
Система выполнит проверку соединения с доменом и вернет всплывающее уведомление с результатами теста. Система не выполняет проверку возможности входа в систему и правильность настройки группы пользователей.
- Если вы хотите настроить доменную аутентификацию для пользователя с ролью Главного администратора, в поле Группа главных администраторов укажите
DistinguishedNameгруппы FreeIPA, в которой состоит пользователь. Для Главного администратора дополнительные роли активированы автоматически, поэтому их не нужно добавлять отдельно.Если для пользователя указано несколько групп в одном тенанте, будет использована роль с наибольшими правами и дополнительные роли, если дополнительные роли были назначены.
Пример ввода фильтра:
CN=KUMA team,OU=Groups,OU=Clients,DC=test,DC=domain - Нажмите на кнопку Сохранить.
Соединение с контроллером домена Active Directory будет настроено.