Документооборот для BPMSoft

  1. Главная
  2. Документы
  3. Документооборот для BPMSoft
  4. Установка продукта Документооборот для BPMSoft
  5. Дополнительные подключения
  6. AD/LDAP: настройка и проверка доступа

AD/LDAP: настройка и проверка доступа

Интеграция со службой каталогов помогает поддерживать пользователей и состав ролей BPMSoft по данным организации. Настройте подключение на уровне платформы, затем проверьте права сотрудников в Документообороте. Начните с отдельной тестовой группы: изменение фильтра или состава синхронизируемой группы может повлиять на доступ уже работающих пользователей.

Определите, какие задачи решает интеграция

Задача Проверяемый результат
Синхронизация AD/LDAP Нужные пользователи и членство в группах отражаются в BPMSoft.
Аутентификация средствами LDAP Пользователь входит с учётными данными каталога в соответствии с настроенным способом проверки.
Единый вход (SSO) Браузерный вход проходит через выбранного поставщика удостоверений по отдельному поддерживаемому протоколу.
Доступ к Документообороту У пользователя есть необходимые лицензии и роли, а права на документы и файлы соответствуют его работе.

Синхронизация каталога сама по себе не настраивает SSO и не выдаёт права на все документы. Протокол и поставщик SSO согласуются отдельно для конкретной версии BPMSoft. Работу с LDAP на других ОС, с Kerberos или с другим каталогом также проверяют как отдельный профиль.

Подготовьте параметры каталога

Администратор каталога передаёт параметры подключения и согласованный набор объектов. В таблице приведены технические параметры, которые нужно сопоставить с полями страницы интеграции вашей поставки BPMSoft.

Параметр Что указать или согласовать
Сервер и транспорт ad.example.org, порт и режим: LDAPS 636/TCP либо LDAP с STARTTLS 389/TCP, если выбранный адаптер BPMSoft поддерживает этот режим.
Сервисная учётная запись Учетная запись чтения согласованной области каталога; формат bind-имени, срок действия и владелец пароля. Административные права на домен для чтения не нужны.
Базовый DN Корень поиска, например DC=example,DC=org, или более узкая OU для пилотной группы.
Фильтры Отбор пользователей и групп, исключение ненужных технических записей; правила прямого и вложенного членства.
Атрибуты Идентификатор записи, логин, имя, email и необходимые дополнительные поля. Для AD типичны objectGUID, sAMAccountName или userPrincipalName, displayName и mail; применяйте сопоставление своего адаптера.
Роли и лицензии Какому подразделению или роли BPMSoft соответствует каждая группа; какие лицензии должны получить её участники.
Изменения состава Что происходит при отключении пользователя, удалении из группы, переименовании и переносе записи.
Запуск Ручная проверка, расписание после пилота, ответственный за просмотр результатов и ошибок.

Проверяйте DNS, порт и доверие сертификату из среды BPMSoft. Порт 389 сам по себе не включает STARTTLS; используйте только поддерживаемый платформой и каталогом способ соединения. Служебной учётной записи достаточно чтения согласованной области.

Проверьте доступ и настройте подключение

  1. Сохраните действующие настройки синхронизации и сопоставление групп с ролями. Убедитесь, что предусмотрен локальный административный вход для обслуживания приложения.
  2. Проверьте разрешение имени контроллера и доступ к согласованному порту из среды BPMSoft. Для внутреннего CA добавьте доверенную цепочку в среду процесса приложения.
  3. Заполните подключение по шагам и таблице ниже. До сохранения ограничьте области поиска и фильтры пилотной группой.
  4. Перед сохранением ограничьте синхронизацию пилотной областью и согласованными фильтрами. Убедитесь, что служебная учётная запись читает только нужные записи.
  5. До массового запуска сравните выбранные логины и контакты с существующими записями BPMSoft. Разберите совпадения и дубли, сохраняя связь с уже созданными документами и задачами.

Для предварительной проверки LDAPS можно использовать команду без передачи учётных данных:

timeout 15 openssl s_client \
  -connect ad.example.org:636 \
  -servername ad.example.org -verify_hostname ad.example.org \
  -verify_return_error </dev/null

Она проверяет TLS из своей среды, но не подтверждает bind, чтение пользователей или синхронизацию BPMSoft. Для STARTTLS диагностика выполняется соответствующим LDAP-клиентом и только при подтверждённой поддержке выбранного профиля.

Заполните подключение LDAP

Откройте Дизайнер системы → Настройка интеграции с LDAP. Для настройки требуется право CanManageAdministration. Подготовьте параметры пилотной области до сохранения: сохранение подключения запускает импорт LDAP.

  1. Укажите имя сервера, способ аутентификации и служебную учётную запись чтения. Формат имени учётной записи должен соответствовать каталогу.
  2. Настройте защищённое соединение и доверие сертификату. Признак «Включить LDAP по SSL» относится к SSL-подключению; он не включает STARTTLS автоматически. Доступность поля зависит от возможностей версии платформы.
  3. Укажите отдельные области поиска пользователей и групп. Для первого импорта ограничьте их тестовой OU или фильтром согласованной группы.
  4. Заполните фильтры и атрибуты по таблице. Не заменяйте идентификатор пользователя или группы отображаемым именем: от идентификатора зависит сопоставление существующих записей.
  5. Проверьте режим автоматического создания пользователей, распределения лицензий и интервал синхронизации. Выберите их до массового подключения; сам импорт каталога не означает выдачу всех нужных лицензий.
  6. Сохраните настройки, дождитесь окончания импорта и проверьте результат пилотной группы. Затем свяжите группы с ролями BPMSoft и проверьте вход обычного сотрудника.
Параметр Поле или код настройки Что задать
Сервер LDAPServer Имя или IP-адрес сервера каталога по выбранному способу подключения.
Аутентификация LDAPAuthType Поддерживаемый каталогом и платформой тип аутентификации.
Учётные данные LDAPServerLogin, LDAPServerPassword Логин чтения каталога и пароль. Пароль заполняйте в защищённом поле.
Защищённое соединение LDAPUseSecureConnection «Включить LDAP по SSL» для соответствующего профиля; проверьте сертификат и доступ из среды приложения.
Области поиска LDAPUsersEntry, LDAPGroupsEntry DN области пользователей и DN области групп.
Фильтры LDAPUsersFilter, LDAPGroupsFilter, LDAPUsersInGroupFilter Условия отбора пользователей, групп и пользователей группы. Сначала проверьте пилотную выборку.
Идентификаторы LDAPUserIdentityAttribute, LDAPGroupIdentityAttribute Стабильные уникальные атрибуты каталога; для AD обычно objectGUID.
Логин и данные сотрудника LDAPUserLoginAttribute, LDAPUserFullNameAttribute, LDAPUserEmailAttribute Атрибуты логина, ФИО и email. Значения должны соответствовать выбранному правилу входа и сопоставления.
Название группы LDAPGroupNameAttribute Атрибут отображаемого имени группы.
Периодичность LDAPSynchInterval Интервал в часах, согласованный для синхронизации каталога.

После синхронизации откройте «Пользователи и администрирование», сопоставьте импортированные группы с нужными ролями, проверьте состав роли и назначение лицензий. Сопоставьте время запуска с LDAP.log и журналом процессов; завершение процесса без проверки выборки недостаточно.

Свяжите группы и пользователей с BPMSoft

При сопоставлении групп каталога с ролями заполните следующие поля:

  1. В дизайнере системы откройте Организационные роли или Функциональные роли и выберите роль для пилотной группы.
  2. На вкладке Пользователи включите Синхронизировать с LDAP и заполните Элемент LDAP соответствующей группой. Сверьте, какие права наследуются от этой роли.
  3. Выполните предусмотренный поставкой ручной запуск синхронизации. Сопоставьте состав группы в каталоге и пользователей роли в приложении.
  4. Если пользователь связывается с каталогом вручную, на его карточке используется признак Аутентификация средствами LDAP, а Имя пользователя выбирается из доступных записей каталога. Не создавайте второй профиль для уже существующего сотрудника.
  5. Проверьте активность, контакт, email и лицензии пользователя. Затем выполните вход обычного сотрудника и проверьте нужные документы, файлы и действия маршрута.

Для созданного пользователя проверьте активность, связанный контакт, email, выбранную LDAP-аутентификацию и импортированную запись каталога. Не создавайте дубль существующего сотрудника. Права продукта проверяйте по первичной настройке.

Проверьте синхронизацию и последующие изменения

Действие в пилоте Что проверить в BPMSoft
Первый запуск Созданы или связаны ожидаемые пользователи; посторонние записи отсутствуют; роли и email верны.
Повторный запуск без изменений Нет новых дублей контактов и пользователей.
Изменение данных тестового сотрудника Обновились только поля, для которых настроена синхронизация.
Добавление в тестовую группу и исключение из неё Состав роли и доступ изменились по принятому правилу; вручную выданные права проверены отдельно.
Отключение тестовой учётной записи Получен предусмотренный результат синхронизации и проверен следующий вход.
Запуск по расписанию Результат повторяется без ручной команды; уведомления и журнал доступны администратору.

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

Диагностика

Результаты синхронизации проверьте в уведомлениях, журнале процесса «Синхронизировать данные о пользователях с LDAP» и LDAP.log. Сопоставьте время, итог обработки, сообщения о лицензиях и дубликатах. Не публикуйте содержимое записей каталога в открытых обращениях.

Симптом Проверка
Каталог недоступен DNS, маршрут, TLS и политика доступа из среды BPMSoft.
Отказ при аутентификации Bind-имя, действительность пароля и допустимый метод входа сервисной учётной записи.
Не найден нужный пользователь Базовый DN, фильтр, права чтения и правило членства в группе.
Пользователь создан, но не входит или не видит документы Активность, лицензии, выбранная аутентификация и права роли.
Ошибки сопоставления Совпадающие логины, дубли контактов и связь существующего пользователя с записью каталога.

Если проблема касается SSO, проверяйте его отдельно: профиль поставщика удостоверений, адрес приложения, сертификаты, идентификатор пользователя и результат входа. Успешная LDAP-синхронизация не является проверкой SSO.

Пример параметров Active Directory

Для первой синхронизации используйте небольшую отдельную OU с двумя контрольными сотрудниками и группой. Имена ниже — примеры, не готовая конфигурация любого домена:

Параметр Пример и смысл
Контроллер dc01.example.org, доступный из приложения
Область пользователей OU=DocflowPilot,DC=example,DC=org
Область групп DN согласованной OU групп
Логин sAMAccountName либо userPrincipalName по правилу входа
ФИО displayName
Email mail
Стабильный идентификатор objectGUID, а не отображаемое имя
Имя группы cn по принятой модели каталога

DN — путь записи в каталоге, а не DNS-имя и не URL сайта. Атрибуты должны реально присутствовать у выбранных записей. Поля фильтра платформы могут включать шаблонные параметры: сохраняйте синтаксис адаптера своей поставки, не подставляйте туда произвольный фильтр из другой библиотеки.

До первого сохранения

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

Для LDAPS проверьте цепочку сертификата в ОС/контейнере процесса BPMSoft. Успешный OpenSSL на рабочем месте не подтверждает доверие службы. Выбранное поле SSL не означает автоматическую поддержку STARTTLS на порту 389.

Привязка существующих сотрудников

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

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

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

Был ли данный материал полезен вам? Да Нет