Перейти к основному содержимому

Изменение настроек LDAP в облачной версии

Если ваш тарифный план облачной версии поддерживает эту функцию, вы можете импортировать пользователей и группы с сервера LDAP. Для начала необходимо создать учетные записи для всех сотрудников компании. Однако если в компании более 50 человек, создание новых пользователей портала может занять много времени. Функция Настройки LDAP позволяет буквально за несколько минут импортировать на портал пользователей и группы с сервера LDAP (например, OpenLDAP Server или Microsoft Active Directory). Новым пользователям не придется создавать новые пароли, поскольку они смогут входить на портал под своими учетными данными, сохраненными на сервере LDAP.

Перейдите в Настройки и нажмите Настройки LDAP в разделе Интеграция.

Импорт пользователей и групп​

примечание

Если вы подключаетесь к Active Directory, которая содержит более 1000 пользователей, вам потребуется увеличить лимит AD MaxPageSize = 1000 с помощью утилиты ntdsutil. Подробные инструкции о том, как это сделать, доступны здесь.

  1. В Настройках портала откройте страницу Настройки LDAP в разделе Интеграция на левой боковой панели.

  2. Нажмите на переключатель Включить аутентификацию LDAP (если вы меняете настройки повторно, используйте ссылку Показать рядом с заголовком Настройки LDAP, чтобы отобразить форму для ввода параметров).

  3. Установите флажок Включить StartTLS, если вы хотите обеспечить безопасное соединение с помощью технологии StartTLS (в этом случае используется стандартный порт 389). Установите флажок Включить SSL, если хотите использовать протокол SSL (в этом случае номер порта автоматически изменится на 636).

  4. Заполните поля, необходимые для импорта пользователей (обязательные поля помечены звездочкой):

    Настройки LDAP — пользователи

    Внимание

    Обратите внимание, что если вы уже импортировали пользователей, а затем изменили любую из следующих настроек (например, Сервер, Фильтр пользователей, DN каталога пользователей, Фильтр групп, DN каталога групп), существующие пользователи и все их данные, включая документы и сообщения электронной почты, не соответствующие обновленным настройкам, будут ОТКЛЮЧЕНЫ. Настоятельно рекомендуется сделать резервную копию, прежде чем менять какие-либо настройки.

    • в поле Сервер введите URL-адрес сервера LDAP в формате protocol://host, например, LDAP://example.com для обычного соединения с сервером LDAP или LDAPS://example.com для безопасного соединения с сервером LDAP по протоколу SSL. Вместо DNS-имени можно также указать IP-адрес сервера: LDAP://192.168.3.202;

    • укажите Номер порта, используемый для соединения с сервером LDAP. Для обычного соединения с сервером LDAP по умолчанию используется порт 389. Если вы включили опцию StartTLS, также используется стандартный порт 389. Если включена опция SSL, номер порта автоматически изменяется на 636;

    • в поле DN каталога пользователей (англ. User Distinguished Name) укажите абсолютный путь к каталогу верхнего уровня, содержащему пользователей, которых требуется импортировать. Этот параметр определяет узел, с которого начинается поиск. Можно указать корневой каталог, например, dc=example,dc=com, чтобы осуществлять поиск пользователей по всему каталогу, или задать определенную область поиска, например, ou=groupname,dc=example,dc=com, чтобы осуществлять поиск пользователей внутри указанной группы;

    • укажите значение Атрибут логина (атрибут в записи пользователя, соответствующий логину, который пользователи сервера LDAP будут использовать для входа в ONLYOFFICE);

      примечание

      Обратите внимание: настройки по умолчанию указаны для Active Directory. Для OpenLDAP Server необходимо изменить следующие настройки:

      • Фильтр пользователей — (uid=*)
      • Атрибут логина — uid

    • заполните поле Фильтр пользователей, если необходимо импортировать пользователей, соответствующих указанным критериям поиска. Значение фильтра по умолчанию (uid=*) позволяет импортировать всех пользователей;

      примечание

      Примеры синтаксиса фильтра поиска можно посмотреть здесь.

  5. В разделе Сопоставление атрибутов можно установить соответствие между полями с данными пользователя на портале и атрибутами в записи пользователя на сервере LDAP. Нажмите Добавить атрибут, выберите из списка нужное поле данных и укажите атрибут пользователя, используемый на вашем сервере LDAP. Значения следующих параметров заданы по умолчанию, но в случае необходимости их можно изменить:

    Настройки LDAP — сопоставление атрибутов

    • Имя (атрибут в записи пользователя, соответствующий имени пользователя)
    • Фамилия (атрибут в записи пользователя, соответствующий фамилии пользователя)
    • Почта (атрибут в записи пользователя, соответствующий адресу электронной почты пользователя)
    • Должность (атрибут в записи пользователя, соответствующий должности пользователя)
    • Основной мобильный телефон (атрибут в записи пользователя, соответствующий номеру мобильного телефона пользователя)
    • Местоположение (атрибут в записи пользователя, соответствующий местоположению пользователя)

    Вы также можете добавить следующие атрибуты: Дата рождения, Пол, Фото профиля, Дополнительный телефон, Дополнительный мобильный телефон, Дополнительная почта, Skype.

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

    примечание

    Обратите внимание: если вы решите добавить группы, будут импортированы только те пользователи, которые состоят хотя бы в одной группе.

    Настройки LDAP — группы

    Внимание

    Обратите внимание, что если вы уже импортировали пользователей и изменили некоторые настройки (например, Сервер, Фильтр пользователей, DN каталога пользователей, Фильтр групп, DN каталога групп), существующие пользователи и все их данные, включая документы, сообщения электронной почты и другие, не соответствующие новым настройкам, будут ОТКЛЮЧЕНЫ. Мы настоятельно рекомендуем сделать резервную копию, прежде чем вы измените какие-либо настройки.

    • в поле DN каталога групп (англ. Group Distinguished Name) укажите абсолютный путь к каталогу верхнего уровня, содержащему группы, которые требуется импортировать, например, ou=Groups,dc=example,dc=com.

    • Атрибут пользователя (атрибут, который определяет, состоит ли этот пользователь в группах);

    • заполните поле Фильтр групп, если необходимо импортировать группы, соответствующие указанным критериям поиска. Значение фильтра по умолчанию (objectClass=group) позволяет импортировать все группы;

    • значения следующих параметров заданы по умолчанию, но в случае необходимости их можно изменить:

      • Атрибут названия группы (атрибут, который соответствует названию группы, в которой состоит пользователь)
      • Атрибут группы (атрибут, который указывает, какие пользователи состоят в этой группе)
      примечание

      Обратите внимание: настройки по умолчанию указаны для Active Directory. Для OpenLDAP Server необходимо изменить следующие настройки:

      • Фильтр групп — (objectClass=posixGroup)
      • Атрибут пользователя — uid
      • Атрибут группы — memberUid

  7. Включите переключатель Аутентификация пользователей, если у текущего пользователя Windows нет прав на чтение из LDAP server/Active Directory. В полях Логин и Пароль введите учетные данные пользователя, у которого есть права на чтение данных с сервера LDAP (по умолчанию используются логин и пароль текущей сессии Windows).

  8. Отметьте опцию Отправить пригласительное письмо в разделе Дополнительные параметры, если вы хотите отправить приглашения по электронной почте всем новым пользователям. Пригласительное письмо содержит кнопку для перехода на страницу входа на портал и активации адреса электронной почты. Эта возможность доступна, только если настроено сопоставление атрибута почты.

  9. Нажмите кнопку СОХРАНИТЬ.

  10. В открывшемся окне Подтверждение импорта нажмите OK, чтобы начать импорт пользователей.

Длительность импорта зависит от количества пользователей, групп и технических характеристик системы.

примечание

Обратите внимание: адрес электронной почты пользователя портала будет взят из настройки Атрибут почты. Если он отсутствует, то он будет формироваться следующим образом: Атрибут логина + @ + Домен LDAP.

  • Если на портале есть ранее созданный пользователь с таким адресом электронной почты, этот пользователь автоматически будет синхронизирован с LDAP-пользователем.
  • Если такого адреса электронной почты нет, пользователь не будет получать никаких оповещений с портала.

Начиная с версии SaaS v. 11.5 есть следующие особенности:

  • владелец портала не затрагивается изменениями прав доступа через LDAP;
  • если владелец портала исключен из фильтра пользователей или групп, он перестает быть LDAP-пользователем, но остается активным;
  • при выключении LDAP все выданные через LDAP права доступа отбираются у пользователей;
    • если пользователь, выключивший LDAP, должен был лишиться прав администратора, эти права остаются, но пользователь получает уведомление,
  • если пользователь исключен из фильтра пользователей/групп, он остается активным и получает уведомление о том, что LDAP-пароль недействителен и его нужно сменить на странице настроек профиля,
  • если пользователь пытается снять с себя права администратора (через настройки прав доступа или исключив себя из фильтра пользователей/групп), его права администратора остаются, а он получает уведомление.

Аутентификация LDAP-пользователей​

Каждый импортированный пользователь сможет входить на портал, используя логин, формируемый по следующим схемам:

  • Атрибут логина, например, Andrew.Stone
  • Атрибут логина + @ + Домен LDAP, например, Andrew.Stone@example.com
  • Домен LDAP + \ + Атрибут логина (поддерживаются неполные имена доменов), например, example\Andrew.Stone

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

Аутентификация LDAP-пользователей

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

Синхронизация данных LDAP​

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

Чтобы настроить параметры синхронизации, включите переключатель Автоматическая синхронизация и задайте нужное время выполнения автоматической синхронизации: данные можно синхронизировать каждый час в указанные минуты, каждый день в указанное время, а также каждую неделю или месяц в указанный день и время. Нажмите Сохранить, чтобы применить настройки. Также можно синхронизировать данные вручную, нажав Синхронизировать пользователей внизу страницы LDAP. Кроме того, можно использовать кнопку СОХРАНИТЬ внизу раздела Настройки LDAP.

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