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

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

Как читать таблицы и редактировать значения, описано в разделе [Настройки в Constance](https://webim.ru/kb/11.0/settings/constance/).

## Безопасность и авторизация { #security }

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

## SSO / LDAP / Kerberos { #sso-ldap-kerberos }

| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
| `SSO_SETTINGS` | JSON-объект | См. [Формат SSO_SETTINGS](#sso-settings) | Параметры сквозной авторизации сотрудников через Active Directory. Формат и поля описаны в разделе [Формат SSO_SETTINGS](#sso-settings).<br>Зависит от тарифной возможности `sso`: без неё сквозная авторизация выключена. |
| `LDAP` | JSON-объект | См. [Формат LDAP](#ldap) | Параметры подключения к Active Directory по протоколу LDAP. Формат и поля описаны в разделе [Формат LDAP](#ldap).<br>Зависит от тарифной возможности `sso`: без неё интеграция не используется. Значение поля `password` скрыто в форме редактирования. |
| `KERBOS` | JSON-объект | См. [Формат KERBOS](#kerberos) | Параметры единого входа по протоколу Kerberos. Формат и поля описаны в разделе [Формат KERBOS](#kerberos).<br>Зависит от тарифной возможности `sso`: без неё интеграция не используется. |

## Интеграции { #integrations }

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

## Формат SSO_SETTINGS { #sso-settings }

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

Пример:

```json
{
  "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` | Режим входа.<br>`only_sso` — только сквозная авторизация, вход по паролю запрещён.<br>`sso_and_common_auth` — сквозная авторизация и вход по паролю. Сотрудник, связанный с учётной записью Active Directory, может войти по паролю, только если это разрешено в его профиле.<br>`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 { #ldap }

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

!!! Note "Примечание"

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

Пример:

```json
{
  "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 }

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

Пример:

```json
{
  "kerberos_service_name": "HTTP",
  "dev_mode": false,
  "dev_mode_username": "admin"
}
```

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

---

Источник: https://webim.ru/kb/11.0/settings/constance/security.html
