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