Перейти к содержанию

Загрузить пользователей с использованием LDAP и LDAPS

Действия выполняются в текущем ВЦОД.

Sharx Base подключается к внешним каталогам OpenLDAP, FreeIPA и Active Directory по протоколам LDAP и LDAPS. После включения синхронизации система загружает найденных пользователей в текущий ВЦОД и создаёт для них учётные записи.

Права доступа

Права доступа к LDAP- и LDAPS-конфигурациям и загруженным пользователям:

Действие Доступные роли
Создание, изменение и удаление конфигурации LDAP или LDAPS Администратор ВЦОД
Просмотр списка и параметров конфигураций Администратор ВЦОД
Администратор безопасности ВЦОД
Включение и отключение синхронизации, выбор активной конфигурации Администратор ВЦОД
Просмотр загруженных пользователей Администратор ВЦОД
Администратор безопасности ВЦОД
Изменение роли и удаление загруженного пользователя Администратор ВЦОД

Требования к LDAP-серверу

Перед подключением подготовьте на LDAP-сервере:

  • служебную учётную запись, от имени которой Sharx Base сможет искать пользователей и группы;
  • базовый DN, относительно которого будет выполняться поиск;
  • фильтры поиска пользователей и групп;
  • LDAP-группы, которые будут сопоставлены ролям Sharx Base;
  • тестового пользователя с известными логином и паролем.

Для каждого загружаемого пользователя должны быть заполнены следующие атрибуты:

  • uid — логин пользователя;
  • activeStatus — статус учётной записи;
  • mail — адрес электронной почты.

В веб-интерфейсе атрибуты сопоставляются автоматически в соответствии с выбранной службой каталогов. Если обязательный атрибут отсутствует или не заполнен, учётная запись не будет загружена в Sharx Base.

Для подключения по LDAPS дополнительно подготовьте:

  • полное доменное имя (FQDN) LDAP-сервера, совпадающее с именем в его сертификате;
  • действующий сертификат удостоверяющего центра или цепочку сертификатов в формате PEM;
  • сетевой доступ от узлов Sharx Base к LDAP-серверу. Обычно LDAP использует TCP-порт 389, LDAPS — TCP-порт 636.

Ограничения

Внимание

В одном ВЦОД можно создать несколько конфигураций LDAP и LDAPS, но для синхронизации можно выбрать только одну из них

Учитывайте следующие особенности назначения ролей:

  • пользователю можно назначить только одну роль Sharx Base по умолчанию;
  • сопоставление LDAP-группы с ролью применяется только при первой загрузке пользователя;
  • последующие изменения сопоставления групп не изменяют роли загруженного пользователя;
  • после первой загрузки роль пользователя можно изменить в разделе Администрирование > Пользователи > Учётные записи;
  • в командной строке LDAP-группу можно сопоставить с пользовательскими ролями. Если пользователю назначается несколько ролей, укажите их в сопоставлении одной LDAP-группы.

Важно

Избегайте одинаковых логинов на разных LDAP-серверах. При переключении сервера учётная запись с таким же логином остаётся в списке и не заменяется автоматически.

Чтобы загрузить пользователя с тем же логином с другого сервера, удалите прежнюю учётную запись и выполните aaa user clear --login <LOGIN>. Команда доступна только в интерфейсе командной строки


Создать конфигурацию LDAP или LDAPS

Таблица — Параметры конфигурации LDAP или LDAPS.

Поле Описание
Имя Уникальное имя конфигурации в пределах текущего ВЦОД.
Имя не должно содержать кириллицу, пробелы, точки, запятые и специальные символы.
Допускаются латинские буквы, цифры, дефис - и нижнее подчёркивание _
Описание Дополнительная информация о конфигурации
Расположение Директория ВЦОД, в которой будут созданы учётные записи пользователей LDAP
Тип каталога Протокол подключения: LDAP или LDAPS
Сертификат Поле используется только для LDAPS.
Способ передачи сертификата: Вручную или Указать путь.
Путь предоставляется технической поддержкой ООО «Шаркс ДЦ»
Служба каталогов Тип подключаемой службы: OpenLDAP, FreeIPA или Active Directory
Адрес IP-адрес или доменное имя LDAP-сервера.
Для LDAPS укажите FQDN, соответствующее сертификату сервера
Пользователь DN служебной учётной записи LDAP
Пароль Пароль служебной учётной записи LDAP
Базовое имя Базовый DN, относительно которого выполняется поиск пользователей и групп
Сопоставление групп Соответствие LDAP-группы роли Sharx Base по умолчанию
Поиск групп LDAP-фильтр поиска групп
Поиск пользователей LDAP-фильтр поиска пользователей
Маршрут нотификации Заранее созданный маршрут уведомлений об ошибках подключения и синхронизации
Ошибки до нотификации Количество повторений одинаковой ошибки, после которого отправляется уведомление.
Допустимые значения — целые числа от 1, верхняя граница не установлена.
Значение по умолчанию — 3

Чтобы создать конфигурацию:

  1. Перейдите в раздел Администрирование > LDAP.
  2. Нажмите кнопку Добавить каталог.
  3. В блоке Общие укажите имя, описание и расположение загружаемых пользователей.
  4. В блоке Подключение выберите LDAP или LDAPS.
  5. Если выбрали LDAPS, в поле Сертификат укажите способ передачи сертификата:

    • Вручную — вставьте полное содержимое PEM-сертификата или цепочки, включая строки -----BEGIN CERTIFICATE----- и -----END CERTIFICATE-----;
    • Указать путь — укажите путь к файлу сертификата. Путь предоставляется технической поддержкой ООО «Шаркс ДЦ».
  6. Выберите службу каталогов.

  7. Укажите адрес сервера, DN и пароль служебной учётной записи.
  8. В блоке Параметры поиска укажите базовый DN, сопоставьте LDAP-группу с одной ролью по умолчанию, затем задайте фильтры поиска групп и пользователей.
  9. При необходимости в блоке Расширенные параметры выберите маршрут уведомлений и измените значение поля Ошибки до нотификации.

    Создание конфигурации LDAP

    Создание конфигурации LDAPS

  10. Нажмите кнопку Создать.

Созданная конфигурация появится в списке со статусом НЕ ПОДКЛЮЧЕН. Включение синхронизации и проверка пользователя выполняются одинаково для LDAP и LDAPS.


Просмотреть конфигурации и статус подключения

  1. Перейдите в раздел Администрирование > LDAP.
  2. Просмотрите список конфигураций. В столбце Статус отображается состояние подключения.
  3. Чтобы просмотреть параметры конфигурации, нажмите кнопку в её строке.

Список конфигураций LDAP и LDAPS

В списке может быть несколько конфигураций. Статус ПОДКЛЮЧЕН имеет только конфигурация, выбранная для синхронизации.


Включить синхронизацию

Включение синхронизации изменяет параметры безопасности текущего ВЦОД. Действие доступно только Администратору ВЦОД.

  1. Перейдите в раздел Администрирование > Настройки безопасности.
  2. На вкладке Общие в блоке Настройки авторизации нажмите Изменить.
  3. Включите параметр Включить синхронизацию с LDAP.
  4. В поле Доступные LDAP-серверы выберите созданную конфигурацию LDAP или LDAPS.
  5. Нажмите кнопку Сохранить.

Включение синхронизации с LDAP

После сохранения Sharx Base подключается к выбранному серверу, выполняет поиск по заданным фильтрам и загружает найденных пользователей.


Проверить загрузку и вход пользователя

  1. Перейдите в раздел Администрирование > LDAP и убедитесь, что выбранная конфигурация имеет статус ПОДКЛЮЧЕН.
  2. Перейдите в раздел Администрирование > Пользователи > Учётные записи.
  3. Найдите загруженного пользователя.
  4. Убедитесь, что учётная запись активна, находится в директории, выбранной в поле Расположение, и ей назначена ожидаемая роль.

    Пользователь, загруженный из LDAP

После появления учётной записи в списке пользователь может войти в текущий ВЦОД с логином и паролем из LDAP. Пароль пользователя в Sharx Base не хранится: при каждом входе его проверяет LDAP-сервер.

Примечание

Если синхронизация выключена или LDAP-сервер недоступен, пользователь LDAP не сможет войти, даже если его учётная запись отображается в списке Sharx Base


Изменить роль загруженного пользователя

Сопоставление группы с ролью применяется только при первой загрузке пользователя. После этого роль можно изменить только средствами Sharx Base: при изменении LDAP-конфигурации она не обновляется.

  1. Перейдите в раздел Администрирование > Пользователи > Учётные записи.
  2. В строке пользователя нажмите кнопку .
  3. Измените роль пользователя.
  4. Нажмите кнопку Сохранить.

Подробнее см. в статье Пользователи.


Отключить синхронизацию или сменить сервер

  1. Перейдите в раздел Администрирование > Настройки безопасности.
  2. На вкладке Общие в блоке Настройки авторизации нажмите Изменить.
  3. Выполните одно из действий:

    • чтобы отключить LDAP-аутентификацию, выключите параметр Включить синхронизацию с LDAP;
    • чтобы подключить другой сервер, выберите другую конфигурацию в поле Доступные LDAP-серверы.
  4. Нажмите кнопку Сохранить.

При временном отключении синхронизации не удаляйте пользователей, если планируете использовать их снова. После повторного включения синхронизации существующие учётные записи продолжат использоваться.


Повторно загрузить удалённого пользователя

После ручного удаления LDAP-пользователя повторная синхронизация не создаёт его заново: в системе сохраняется запись об удалении.

Чтобы разрешить повторную загрузку пользователя:

  1. Откройте интерфейс командной строки в текущем ВЦОД.
  2. Очистите запись об удалённом пользователе:

    aaa user clear --login <LOGIN>
    
  3. Убедитесь, что нужная конфигурация LDAP или LDAPS выбрана и синхронизация включена.

  4. Дождитесь повторной загрузки пользователя.

В веб-интерфейсе команда clear отсутствует.


Если подключение не выполнено

Сразу после создания конфигурации отображается статус НЕ ПОДКЛЮЧЕН. Это не является ошибкой, подключение устанавливается после выбора конфигурации и включения синхронизации.

Если после включения синхронизации конфигурация осталась в статусе НЕ ПОДКЛЮЧЕН или перешла в статус ОШИБКА, выполните следующие действия:

  1. Перейдите в раздел Администрирование > Настройки безопасности и убедитесь в следующем:

    • параметр Включить синхронизацию с LDAP включён;
    • в поле Доступные LDAP-серверы выбрана нужная конфигурация;
    • изменения сохранены.
  2. Проверьте сервер:

    • сервер доступен из сети управления Sharx Base;
    • доменное имя сервера корректно заполнено в поле Адрес.
  3. Проверьте DN и пароль служебной учётной записи. Учётная запись должна быть активна и иметь права на поиск пользователей и групп в пределах указанного Базового имени.

  4. Проверьте Базовое имя, фильтры поиска пользователей и групп. Пользователи и группы должны находиться в указанной ветви LDAP-каталога.
  5. Для LDAPS дополнительно проверьте:

    • адрес совпадает с именем, указанным в сертификате сервера;
    • срок действия сертификата не истёк;
    • передан сертификат удостоверяющего центра или полная цепочка сертификатов;
    • сертификат содержит строки -----BEGIN CERTIFICATE----- и -----END CERTIFICATE-----.
  6. Если подключение установлено, но пользователи не появились, проверьте:

    • наличие у пользователей обязательных атрибутов uid, mail и activeStatus;
    • фильтр поиска пользователей;
    • фильтр поиска групп;
    • название LDAP-группы в сопоставлении групп;
    • наличие пользователей в сопоставленной группе.

После исправления параметров сохраните конфигурацию и повторно проверьте её статус.

Если ошибка сохраняется, зафиксируйте название конфигурации, время возникновения ошибки и отображаемый статус, затем обратитесь в техническую поддержку ООО «Шаркс ДЦ».


Термины и определения содержатся в статьях: