# TLS-сертификаты

Данный раздел актуален только для hosted-аккаунтов. В облаке настройки серверов централизованно выполняются сотрудниками ООО "ВЕБИМ.РУ" для всех облачных аккаунтов вместе.

По умолчанию **Webim Server** проверяет TLS-сертификаты так же, как и большинство других приложений: по системному набору удостоверяющих центров (УЦ, англ. Certificate Authority) и по набору библиотеки Python `certifi`. Сертификат считается **стандартным**, если вся его цепочка заканчивается на CA из этих наборов.

**Нестандартный** сертификат — это сертификат, которому система «из коробки» не доверяет. К таким относятся:

  * самоподписные сертификаты;

  * сертификаты корпоративного или ведомственного УЦ, которого нет в системном наборе серверной ОС (и в `certifi`);

  * сертификаты, в цепочке которых есть промежуточный УЦ, которого нет ни у сервера-источника, ни в локальном хранилище.

Их можно использовать, если дополнительно настроить доверие на стороне **Webim Server**. Без этой настройки соединения будут завершаться ошибкой проверки сертификата — часто с малоинформативным сообщением вроде `Connection #0 to host ... left intact`. Разбор таких ошибок — в статье [Диагностика ошибок TLS](https://webim.ru/kb/devops/tls-certificates/troubleshooting.html).

## Два разных сценария { #two-scenarios }

Ошибки TLS на **Webim Server** возникают в двух независимых направлениях. Важно сразу разобраться, в каком из случаев проблема.

| Направление                                | Кто предъявляет сертификат            | Типичный пример                                                                                                                                                        | Что настраивать                                                                                                             |
|--------------------------------------------|---------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------|
| **Входящие** соединения к **Webim Server** | Сам сервер Webim (или узел перед ним) | Балансировщик с публичным доменом расшифровывает трафик и пересылает его на сервер во внутреннем контуре с самоподписным или корпоративным сертификатом                | Цепочка сертификата на принимающем узле и доверие к внутреннему УЦ на сервере Webim. См. [Входящие соединения](https://webim.ru/kb/devops/tls-certificates/incoming.html) |
| **Исходящие** запросы с **Webim Server**   | Внешний сервис (канал, CRM, бот)      | Канал [MAX](https://webim.ru/kb/channels/social-network-messengers/max.html) использует сертификаты Минцифры РФ, которых нет в стандартной поставке ОС Debian и в библиотеке `certifi` | Добавить УЦ внешней стороны в доверенные на сервере Webim. См. [Исходящие соединения](https://webim.ru/kb/devops/tls-certificates/outgoing.html)                          |

Для веб-браузеров и мобильных приложений посетителей и операторов важен сертификат **того узла, который они видят** (это может быть балансировщик с внешним доменом). Этот сертификат всегда должен быть доверенным для любых браузеров и устройств пользователей. Нестандартный сертификат на внутреннем участке не заменяет публичный сертификат внешнего домена.

## Docker и установка на хост

**Webim Server** поставляется [в Docker-контейнерах](https://webim.ru/kb/devops/hosted-deployment/docker.html) или, по согласованию, устанавливается пакетами напрямую на хост. Хранилище доверенных УЦ у хоста и у контейнера **разное**.

  * Если сертификат добавлен только в системное хранилище хоста, процессы внутри контейнеров его не увидят. В Docker дополнительные УЦ кладут в `/etc/webim/ssl/ca-certificates.crt` — этот путь уже внутри смонтированного `/etc/webim`.

  * У бэкендов Webim и у **Delta Proxy** скрипт запуска читает этот файл, копирует его в `/usr/share/ca-certificates/` и выполняет `update-ca-certificates`. После пересоздания контейнера импорт повторяется сам, если файл на хосте на месте.

Поэтому инструкции для поставки в Docker-контейнерах и для установки на хост различаются. Общая процедура — в статье [Добавление удостоверяющего центра](https://webim.ru/kb/devops/tls-certificates/adding-ca.html).

## Карта документации

| Задача                                                                               | Статья                                                            |
|--------------------------------------------------------------------------------------|-------------------------------------------------------------------|
| Добавить УЦ в системное хранилище и указать его библиотекам, входящим в Webim Server | [Добавление удостоверяющего центра](https://webim.ru/kb/devops/tls-certificates/adding-ca.html)                 |
| Добавить УЦ в контейнеры **Chat Backend** и **Admin Backend**                       | [Установка в Docker](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#install-in-docker)              |
| Добавить УЦ в **Delta Proxy**                                                        | [Delta Proxy](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#delta-proxy)                           |
| Настроить внутренний или самоподписный сертификат на стороне Webim                   | [Входящие соединения](https://webim.ru/kb/devops/tls-certificates/incoming.html)                                |
| Настроить доверие к сертификатам Минцифры РФ и другим нестандартным                  | [Исходящие соединения](https://webim.ru/kb/devops/tls-certificates/outgoing.html)                               |
| Разобрать `CERTIFICATE_VERIFY_FAILED` и найти причину                                | [Диагностика ошибок TLS](https://webim.ru/kb/devops/tls-certificates/troubleshooting.html)                      |
| Задать минимальную версию TLS и обязательный HTTPS для исходящих запросов            | [Безопасность исходящих HTTP(S)-запросов](https://webim.ru/kb/devops/outgoing-http-tls.html) |

---

Источник: https://webim.ru/kb/devops/tls-certificates/index.html
