Настройка интеграции с LDAP

Навигатор по разделу:

1. Настройка подключения к LDAP

Параметры подключения к LDAP-каталогу задаются в секции one_time_merge_auth_provider_ldap конфигурационного файла службы scheduler (/opt/smartpam/scheduler/config.yaml):

one_time_merge_auth_provider_ldap: # подключение LDAP-провайдера
  id: 8aba5e45-77c5-4aa4-ab26-a9ddfa5cbcee # идентификатор LDAP-провайдера (рекомендуется сгенерировать собственный в формате UUID)
  name: example.com # внутреннее имя LDAP-провайдера
  domain: example.com # домен LDAP-провайдера
  query: "(&(objectCategory=person)(objectClass=user)(memberOf=cn=SmartPAMGroup,cn=Users,dc=corp,dc=example,dc=com))" # фильтр импортируемых пользователей (в примере — члены группы SmartPAMGroup)
  url: ldap://10.10.10.4:389 # адрес LDAP-сервера
  bind_username: ldapuser # пользователь LDAP с правами на подключение к каталогу (bind) и чтение данных каталога с применением фильтра query
  bind_password: Passw0rd # пароль пользователя LDAP
  bind_method: ntlm # метод аутентификации при подключении к LDAP-серверу 

Параметры LDAP-провайдера записываются в базу данных задачей планировщика auth.merge_ldap_once. Она выполняется однократно после запуска службы scheduler. Затем задача auth.import_users по сохранённым в БД параметрам периодически синхронизирует пользователей из LDAP-каталога.

Расписание синхронизации задается параметром spec задачи auth.import_users в секции tasks того же конфигурационного файла:

# Разовая операция слияния LDAP (если настроено).
- key: auth.merge_ldap_once
  spec: "@after 10s"
# Периодический импорт пользователей.
- key: auth.import_users
  spec: "@every 1h"

Форматы расписания (@after, @every, cron) описаны в комментариях к секции tasks в разделе "Установка Avanpost SmartPAM из архива".

2. Методы аутентификации при подключении к LDAP

Параметр bind_method определяет способ аутентификации при подключении к LDAP-серверу:

  • при синхронизации пользователей подключение выполняется с учётными данными bind_username и bind_password;
  • при входе LDAP-пользователей в SmartPAM применяется тот же метод, но с именем и паролем входящего пользователя.

Таблица — Возможные значения параметра bind_method

ЗначениеОписание
ntlmMicrosoft Sicily NTLM bind для Active Directory. Использует домен, имя пользователя и пароль. Метод по умолчанию
ntlm-sicilyСиноним ntlm, поведение идентично
ntlm-saslNTLM через SASL-механизм NTLM. Использует домен, имя пользователя и пароль. Предназначен для серверов с поддержкой SASL NTLM, в том числе Samba AD DC, где Sicily NTLM может не поддерживаться
simpleLDAP simple bind с именем пользователя и паролем. Имя передаётся серверу без преобразования, поэтому для служебной учётной записи укажите DN или UPN в формате, подходящем для каталога. Для защиты пароля используйте соединение ldaps://
gssapiSASL GSSAPI / Kerberos v5 с аутентификацией по паролю. Realm формируется из значения domain в верхнем регистре. Если имя пользователя содержит символ @, используется часть до него. Хост из url служит адресом KDC и используется для сервисного principal ldap/<host>. В параметре url укажите DNS-имя LDAP-сервера, соответствующее его Kerberos SPN. KDC должен быть доступен на этом же хосте. Минимальная конфигурация Kerberos создаётся автоматически, системный файл krb5.conf не требуется
anonymousПодключение без аутентификации: передаётся имя пользователя с пустым паролем. Заданный пароль не используется и не проверяется, в том числе при входе LDAP-пользователей. Доступ определяется разрешениями LDAP-сервера для неаутентифицированных соединений
digest-md5SASL DIGEST-MD5 с именем пользователя и паролем. Хост берётся из url. Устаревший механизм, требует поддержки на стороне сервера; Samba его не поддерживает

Особенности обработки параметра:

  • Если параметр bind_method отсутствует или пуст, используется значение ntlm.
  • Регистр значения не учитывается, пробелы в начале и в конце удаляются.
  • Неизвестное значение приводит к ошибке ldap: unknown bind method.
  • Значения sasl и kerberos не поддерживаются: укажите конкретный метод, например ntlm-sasl или gssapi.
  • При ошибке подключения автоматическое переключение на другой метод не выполняется.

Метод аутентификации и шифрование соединения задаются независимо друг от друга. Для использования TLS укажите в url схему ldaps://. Автоматический переход с ldap:// на StartTLS не выполняется.

Значение bind_method из конфигурационного файла можно переопределить переменной окружения ONE_TIME_MERGE_AUTH_PROVIDER_LDAP_BIND_METHOD.

3. Применение изменений параметров LDAP-провайдера

Задача auth.merge_ldap_once создаёт LDAP-провайдер в БД или обновляет существующий по значению параметра id. Чтобы изменения параметров LDAP-провайдера в конфигурационном файле вступили в силу:

1. Отредактируйте нужные параметры в секции one_time_merge_auth_provider_ldap файла /opt/smartpam/scheduler/config.yaml. Значение id существующего провайдера не изменяйте.

2. Убедитесь, что задача auth.merge_ldap_once включена в секции tasks конфигурационного файла.

3. Перезапустите службу scheduler:

   sudo systemctl restart scheduler.service

4. Дождитесь выполнения задачи auth.merge_ldap_once.

После этого новые параметры будут записаны в БД и применены при следующей синхронизации и входе пользователей.

Обсуждение