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

Безопасность и интеграции

Требования к паролям сотрудников, ограничение входа по IP-адресам, разграничение доступа (ABAC) и тарифные ограничения, сквозная авторизация через Active Directory и Kerberos, интеграции с Zendesk и Creatio.

Как читать таблицы и редактировать значения, описано в разделе Настройки в Constance.

Безопасность и авторизация

Параметр Тип По умолчанию Описание
STRONG_PASSWORDS JSON-объект {} Требования к сложности паролей сотрудников. Пустой объект {} — требования не применяются.
Поля: length — минимальная длина пароля (строка или число); chars — наборы символов, разделённые ::, из каждого набора в пароле должен быть хотя бы один символ. Набор записывается как фрагмент класса символов регулярного выражения.
Пример: {"length": "8", "chars": "a-z::A-Z::0-9"}.
PASSWORD_EXPIRATION Длительность 90 дней
90 00:00:00
Срок действия пароля сотрудника. По истечении срока при входе потребуется сменить пароль. Значение 0 отключает ограничение срока.
ABAC_ENFORCE Логический Включено Включает применение правил разграничения доступа (ABAC). При выключенной настройке нарушения правил только записываются в журнал, а доступ не блокируется.
Не выключайте настройку в рабочей среде.
ABAC_ENFORCE_VISITOR_VISIBILITY Логический Выключено Проверяет по правилам ABAC, должен ли оператор видеть сессию посетителя в РМО. Включение заметно повышает нагрузку на сервер.
TARIFF_ENFORCE Логический Выключено Включает ограничения тарифа: возможности, не входящие в тариф, становятся недоступны. При выключенной настройке доступны все возможности, а в журнал записывается, что станет недоступно после включения.
RESTRICTED_OPTIONS JSON-объект [] Запрет отдельных тарифных возможностей для ролей сотрудников. Ключ — роль, значение — список запрещённых возможностей. Значения [] и {} — запретов нет.
Пример: {"operator": ["operators", "blocked"]}.
OPERATOR_ALLOWED_IPS Список строк [] Список IP-адресов и диапазонов, с которых разрешён вход сотрудников. Пустой список — вход разрешён с любого адреса.
Элемент списка — одиночный адрес или диапазон через дефис, например 192.168.0.123 или 192.168.0.1-192.168.0.50.
В интерфейсе: «Настройки» → «Общие» → «Безопасность».
STORED_DATA_API_ALLOWED_IPS Список строк [] Список IP-адресов и диапазонов, с которых разрешена авторизация в Stored Data API по логину и паролю. Пустой список — без ограничений. Формат элементов такой же, как у OPERATOR_ALLOWED_IPS.
В интерфейсе: «Настройки» → «Общие» → «Безопасность».
RESET_OPERATOR_LOGIN_TRIES_BUTTON Логический Включено Показывает кнопку сброса счётчиков неудачных попыток входа сотрудников и некорректных запросов к API.
SAMPLE_PAGE_REQUIRE_AUTH Логический Включено Требует авторизации сотрудника для открытия демонстрационной страницы виджета /demo/sample-page/. При выключенной настройке страница доступна всем.

SSO / LDAP / Kerberos

Параметр Тип По умолчанию Описание
SSO_SETTINGS JSON-объект См. Формат SSO_SETTINGS Параметры сквозной авторизации сотрудников через Active Directory. Формат и поля описаны в разделе Формат SSO_SETTINGS.
Зависит от тарифной возможности sso: без неё сквозная авторизация выключена.
LDAP JSON-объект См. Формат LDAP Параметры подключения к Active Directory по протоколу LDAP. Формат и поля описаны в разделе Формат LDAP.
Зависит от тарифной возможности sso: без неё интеграция не используется. Значение поля password скрыто в форме редактирования.
KERBOS JSON-объект См. Формат KERBOS Параметры единого входа по протоколу Kerberos. Формат и поля описаны в разделе Формат KERBOS.
Зависит от тарифной возможности sso: без неё интеграция не используется.

Интеграции

Параметр Тип По умолчанию Описание
ZENDESK JSON-объект {} Параметры интеграции с Zendesk.
Поля: zendesk_account — поддомен аккаунта Zendesk; zendesk_login — адрес электронной почты пользователя; zendesk_token — API-токен; zendesk_create_ticket_on_chat_close — создавать тикет при закрытии диалога (true или false).
Пример: {"zendesk_account": "example", "zendesk_login": "agent@example.local", "zendesk_token": "<токен>", "zendesk_create_ticket_on_chat_close": true}.
Значение поля zendesk_token скрыто в форме редактирования.
CREATIOCRM JSON-объект {} Параметры интеграции с Creatio CRM.
Поля: creatiocrm_account_base_url — адрес аккаунта Creatio; creatiocrm_login — логин; creatiocrm_password — пароль; creatiocrm_leads — создавать лиды (true или false).
Зависит от тарифной возможности creatio_crm_integration: без неё интеграция не используется. Значение поля creatiocrm_password скрыто в форме редактирования.

Формат SSO_SETTINGS

Сквозная авторизация позволяет сотрудникам входить в Webim без ввода пароля: браузер передаёт серверу билет Kerberos доменной учётной записи, а данные сотрудника запрашиваются из Active Directory. Для работы сквозной авторизации также нужно заполнить настройки LDAP и KERBOS.

Пример:

{
  "enabled": true,
  "auth_mode": "sso_and_common_auth",
  "create_new_agent_if_not_exist": true,
  "enable_periodic_synchronization": true,
  "allow_manual_synchronization": false,
  "disable_editing_agents_updated_by_sso": true
}
Поле Тип По умолчанию Описание
enabled Логический false Включает сквозную авторизацию.
auth_mode Строка sso_and_common_auth Режим входа.
only_sso — только сквозная авторизация, вход по паролю запрещён.
sso_and_common_auth — сквозная авторизация и вход по паролю. Сотрудник, связанный с учётной записью Active Directory, может войти по паролю, только если это разрешено в его профиле.
only_common_auth — только вход по паролю.
create_new_agent_if_not_exist Логический true Создаёт сотрудника при первом входе через сквозную авторизацию, если сотрудник с такой учётной записью не найден.
enable_periodic_synchronization Логический true Периодически обновляет данные сотрудников из Active Directory.
allow_manual_synchronization Логический false Разрешает запускать синхронизацию с Active Directory вручную.
disable_editing_agents_updated_by_sso Логический true Запрещает редактировать в Webim данные сотрудников, полученные из Active Directory.

Формат LDAP

Параметры подключения к Active Directory. Через LDAP Webim находит учётную запись сотрудника при сквозной авторизации и определяет его группы безопасности.

Примечание

Значение по умолчанию — демонстрационный пример. Перед включением сквозной авторизации замените его параметрами своего каталога.

Пример:

{
  "urls": ["ldaps://dc1.example.local:636", "ldaps://dc2.example.local:636"],
  "user": "cn=webim,ou=service,dc=example,dc=local",
  "password": "<пароль>",
  "search_bases": ["dc=example,dc=local"],
  "search_timeout": 15,
  "security_group_patterns": ["cn={},ou=roles,dc=example,dc=local"],
  "security_group_attribute": "memberOf",
  "use_ssl": true,
  "validate_certificate": true,
  "ca_certs_file": "/etc/ssl/certs/example-ca.pem"
}
Поле Тип Описание
urls Список строк Адреса серверов каталога (ldap:// или ldaps://). Серверы перебираются по порядку до первого успешного подключения.
user Строка DN учётной записи, от имени которой Webim подключается к каталогу.
password Строка Пароль этой учётной записи. Значение скрыто в форме редактирования.
search_bases Список строк Базы поиска (DN), в которых ищутся учётные записи сотрудников.
search_timeout Целое число Тайм-аут поиска в секундах.
security_group_patterns Список строк Шаблоны DN групп безопасности. Вместо {} подставляется название группы безопасности Webim; если DN входит в группы учётной записи, сотрудник получает эту группу.
security_group_attribute Строка Атрибут учётной записи со списком групп, обычно memberOf.
use_ssl Логический Подключается к серверу по SSL/TLS.
validate_certificate Логический Проверяет сертификат сервера каталога. По умолчанию true; отключайте только на тестовых стендах.
ca_certs_file Строка Путь на сервере Webim к файлу корневых сертификатов для проверки сертификата каталога. Обязателен, если сертификат выдан внутренним центром сертификации.

Формат KERBOS

Параметры проверки билетов Kerberos при сквозной авторизации. На сервере Webim должен быть файл keytab с ключом службы (по умолчанию /etc/krb5.keytab).

Пример:

{
  "kerberos_service_name": "HTTP",
  "dev_mode": false,
  "dev_mode_username": "admin"
}
Поле Тип По умолчанию Описание
kerberos_service_name Строка HTTP Имя службы Kerberos, для которой проверяются билеты.
dev_mode Логический false Тестовый режим без проверки билета. В рабочей среде вход в этом режиме блокируется; не включайте его.
dev_mode_username Строка admin Имя пользователя, от имени которого выполняется вход в тестовом режиме.