Page History

Легковесный протокол доступа к каталогам (LDAP) – это открытый, независимый от поставщика, стандартный для отрасли прикладной протокол для доступа и обслуживания распределенных информационных служб каталогов по сети Internet Protocol (IP).

Интеграция с LDAP позволяет подключить экземпляр к серверу LDAP или AD и использовать его в качестве источника пользовательских данных. Он предоставляет возможность подключения к службе каталогов, в которой хранятся данные аутентификации, такие как имена пользователей, пароли, домашние каталоги пользователей, используемые для хранения деловых и других данных и т. д. Глобальной целью механизма LDAP является импорт пользователей в систему. А за счет этого может быть достигнута синхронизация с различными корпоративными сервисами, и одна учетная запись может быть использована для авторизации во всех корпоративных сервисах, таких как электронная почта, сайт, VoIP и т.д.

Относительное уникальное имя (RDN) – это атрибут, определяющий каталог поиска, например: dc=instance,dc=com.

В этой схеме клиент-серверной инфраструктуры экземпляр SimpleOne должен быть клиентом, подключающимся к серверу LDAP.

Система синхронизируется с сервером LDAP двумя способами:

• через Задания по расписанию (автоматически) – скрипт по расписанию, задающий периоды синхронизации (например, каждые 3 часа). Подробнее читайте в статье Скрипты по расписанию Запланированные скрипты.
• через Автоматическую инициализацию (запускается при входе в систему) – когда пользователь входит в систему, система обновляет запрошенные данные. Настройте этот способ синхронизации через свойство user.ldap_autoprovision.

Установка соединения LDAP

Чтобы установить соединение между вашим экземпляром SimpleOne и сервером LDAP, выполните следующие действия:

1. Настройте сервер LDAP.
2. Определите URL-адрес LDAP.
3. Настройте LDAP.
4. Проверьте настройки.
5. (Необязательно) Импорт данных.

Дополнительные инструменты для настройки LDAP-соединения:

1. Журнал LDAP
2. Системные свойства LDAP

Настройка LDAP-сервера 

Anchor
ldap server ldap server

Чтобы настроить LDAP-соединение, выполните следующие шаги:

1. Перейдите в LDAP → Серверы LDAP.
2. Нажмите Создать и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.
4. Скопируйте ID текущей записи.

Поля формы Сервер LDAP

Определение URL-адреса LDAP 

Anchor
ldap url ldap url

Иногда клиентская инфраструктура может содержать более одного сервера LDAP, например, в качестве резервного сервера. В этом случае может потребоваться указать какой-то конкретный сервер, используемый для авторизации, выставив порядок URL. Если у вас несколько серверов, создайте отдельный URL-адрес LDAP для каждого из них.

Чтобы задать URL, выполните следующие шаги:

1. Перейдите в LDAP → Адреса LDAP.
2. Нажмите Создать и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Поля формы Адрес LDAP

Настройка LDAP 

Anchor
ldap ldap

После того как вы настроили сервера LDAP и URL-адреса, а также выполнили все необходимые подготовки инфраструктуры клиента, настройте LDAP.

Чтобы настроить LDAP, выполните следующие шаги:

1. Перейдите в LDAP → Настройка LDAP.
2. Нажмите Создать и заполните поля.
3. Нажмите Сохранить или Сохранить и выйти, чтобы применить изменения.

Вы можете проверить структуру LDAP, нажав Обзор LDAP в соответствующей записи сервера LDAP.

Проверка настроек 

Anchor
test test

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

1. Перейдите в LDAP → Серверы LDAP.
2. Откройте нужную запись.
   1. Нажмите Проверить соединение, чтобы проверить первое по порядку соединение по URL. 
   2. Нажмите Проверить соединения, чтобы проверить все соединения. 

При возникновении ошибок, проверьте Журнал LDAP записи.

Импорт из LDAP 

Anchor
ldap import ldap import

Импортируйте все необходимые данные с вашего сервера LDAP в экземпляр.

Для завершения импорта данных с помощью LDAP вам потребуется настроить следующие системные элементы:

• Настройка LDAP – указывает фильтры для извлечения данных из определенной таблицы LDAP.
• Источник импорта – загружает строки данных для дальнейшей обработки и преобразования.

На схеме ниже показан процесс импорта данных с сервера LDAP.

Подробнее читайте в статье Импорт LDAP.

Пример настройки интеграции с AD

Готовое решение SimpleOne содержит пример настройки подключения к службе Active Directory (AD).

Ознакомьтесь с ним перед настройкой LDAP импорта на экземпляре. Настройки примера поставляются в не редактируемом виде. Используйте пункт бургер-меню Создать копию на формах каждой записи для копирования настроек.

Созданы и настроены следующие записи:

• LDAP Сервер Demo_Active_Directory с примером LDAP URL. В копии записи задайте параметры необходимого сервера.

• настройки LDAP SimpleOneCourses1 и SimpleOneCourses2. Используйте одну из настроек в качестве примера для создания рабочего соединения с AD.
  

  Expand
  title Значения полей
  Поле Значение Описание Фильтр Section Column width 50% Panel title SimpleOneCourses1 (&  (objectClass=person) (sn=*) ) Column width 50% Panel title SimpleOneCourses2 (&  (objectClass=person,top) (sn=*) ) Заданный фильтр выбирает записи пользователей с любым именем для импорта из AD. Поле запроса sAMAccountName Поле, которое используется для подключения к AD и запроса записей. Перечень атрибутов samaccountname,sn,givenname,distinguishedname,msDS-cloudExtensionAttribute6,telephonenumber, mobile,mail,manager,company,useraccountcontrol,thumbnailphoto Атрибуты, возвращаемые запросом LDAP.

  
  

• источник импорта LDAP Users. Используйте один источник импорта для похожих настроек LDAP.
• запланированные импорты Daily Import SimpleOne Employees и Daily Import SimpleOne Employees 2. Данные AD импортируются каждый день в определенное время. Используйте один из импортов как пример создания своего запланированного импорта.
• запланированный скрипт Daily Deletion of Obsolete Import Sets. Скрипт удаляет наборы для источника импорта данных LDAP Users и связанные записи в таблице Элементы наборов. Скрипт удаляет все наборы импорта, кроме последнего созданного.

Для соединения и импорта пользователей из AD, выполните следующие шаги:

1. Создайте локальный пакет в приложении Simple для настройки LDAP импорта.
2. Создайте копии записей, упомянутых выше, и настройте интеграцию LDAP, изменив значения полей на нужные.
3. Нажмите Проверить соединение на форме сервера LDAP. Если соединение установлено успешно, нажмите Обзор LDAP, чтобы проверить структуру LDAP.
4. После проверки структуры, перейдите на форму нужной настройки LDAP и откройте связанный источник импорта. 
5. (опционально) Нажмите Пробная загрузка (20 записей), чтобы создать тестовый набор импорта.
6. Нажмите Загрузить всe.
7. Нажмите Соотношения таблиц для создания Схемы трансформации. Значение поля Исходная таблица должно совпадать со значением поля Таблица на форме Настройки LDAP.
8. На форме Схемы трансформации создайте соотношения полей через связанный список. Для полей Логин и Электронная почта установлен флажок Объединить данные. Параметр определяет поля целевой таблицы, которые будут использоваться для поиска записей на основе импортированных данных. Если запись найдена в целевой таблице, она будет обновлена. В противном случае будет создана новая запись.
9. Вернитесь на форму Источника импорта и откройте запись Набора импорта через связанный список.
10. Нажмите Трансформировать, чтобы импортировать данные из AD.
11. Настройте копию запланированного импорта Daily Import SimpleOne Employees. Добавьте ссылку на ранее созданный источник импорта.
12. Настройте копию запланированного скрипта Daily Deletion of Obsolete Import Sets и установите флажок Активно. Скопируйте ID источника импорта в переменную import_source_id скрипта.

Журнал LDAP

Anchor
ldap log ldap log

Если в системе произошла ошибка, вы можете проверить сообщения журнала, чтобы найти причину. В Журнале LDAP можно найти записи о неудачных попытках авторизации или попытках обхода политики авторизации. На самом деле все эти сообщения записываются в таблицу Основной журнал (sys_log).

Чтобы перейти в записи журнала, перейдите в LDAP → Журнал LDAP.

Поля формы Журнал LDAP

Системные свойства LDAP 

Anchor
properties properties

Некоторые возможности LDAP можно настроить на стороне клиента с помощью системных свойств. Доступные свойства можно найти в статье Свойства LDAP.