Безопасность и интеграции
Требования к паролям сотрудников, ограничение входа по 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 |
Имя пользователя, от имени которого выполняется вход в тестовом режиме. |