TLS-сертификаты
Данный раздел актуален только для hosted-аккаунтов. В облаке настройки серверов централизованно выполняются сотрудниками ООО "ВЕБИМ.РУ" для всех облачных аккаунтов вместе.
По умолчанию Webim Server проверяет TLS-сертификаты так же, как и большинство других приложений: по системному набору удостоверяющих центров (УЦ, англ. Certificate Authority) и по набору библиотеки Python certifi. Сертификат считается стандартным, если вся его цепочка заканчивается на CA из этих наборов.
Нестандартный сертификат — это сертификат, которому система «из коробки» не доверяет. К таким относятся:
-
самоподписные сертификаты;
-
сертификаты корпоративного или ведомственного УЦ, которого нет в системном наборе серверной ОС (и в
certifi); -
сертификаты, в цепочке которых есть промежуточный УЦ, которого нет ни у сервера-источника, ни в локальном хранилище.
Их можно использовать, если дополнительно настроить доверие на стороне Webim Server. Без этой настройки соединения будут завершаться ошибкой проверки сертификата — часто с малоинформативным сообщением вроде Connection #0 to host ... left intact. Разбор таких ошибок — в статье Диагностика ошибок TLS.
Два разных сценария
Ошибки TLS на Webim Server возникают в двух независимых направлениях. Важно сразу разобраться, в каком из случаев проблема.
| Направление | Кто предъявляет сертификат | Типичный пример | Что настраивать |
|---|---|---|---|
| Входящие соединения к Webim Server | Сам сервер Webim (или узел перед ним) | Балансировщик с публичным доменом расшифровывает трафик и пересылает его на сервер во внутреннем контуре с самоподписным или корпоративным сертификатом | Цепочка сертификата на принимающем узле и доверие к внутреннему УЦ на сервере Webim. См. Входящие соединения |
| Исходящие запросы с Webim Server | Внешний сервис (канал, CRM, бот) | Канал MAX использует сертификаты Минцифры РФ, которых нет в стандартной поставке ОС Debian и в библиотеке certifi |
Добавить УЦ внешней стороны в доверенные на сервере Webim. См. Исходящие соединения |
Для веб-браузеров и мобильных приложений посетителей и операторов важен сертификат того узла, который они видят (это может быть балансировщик с внешним доменом). Этот сертификат всегда должен быть доверенным для любых браузеров и устройств пользователей. Нестандартный сертификат на внутреннем участке не заменяет публичный сертификат внешнего домена.
Docker и установка на хост
Webim Server поставляется в Docker-контейнерах или, по согласованию, устанавливается пакетами напрямую на хост. Хранилище доверенных УЦ у хоста и у контейнера разное.
-
Если сертификат добавлен только в системное хранилище хоста, процессы внутри контейнеров его не увидят. В Docker дополнительные УЦ кладут в
/etc/webim/ssl/ca-certificates.crt— этот путь уже внутри смонтированного/etc/webim. -
У бэкендов Webim и у Delta Proxy скрипт запуска читает этот файл, копирует его в
/usr/share/ca-certificates/и выполняетupdate-ca-certificates. После пересоздания контейнера импорт повторяется сам, если файл на хосте на месте.
Поэтому инструкции для поставки в Docker-контейнерах и для установки на хост различаются. Общая процедура — в статье Добавление удостоверяющего центра.
Карта документации
| Задача | Статья |
|---|---|
| Добавить УЦ в системное хранилище и указать его библиотекам, входящим в Webim Server | Добавление удостоверяющего центра |
| Добавить УЦ в контейнеры Chat Backend и Admin Backend | Установка в Docker |
| Добавить УЦ в Delta Proxy | Delta Proxy |
| Настроить внутренний или самоподписный сертификат на стороне Webim | Входящие соединения |
| Настроить доверие к сертификатам Минцифры РФ и другим нестандартным | Исходящие соединения |
Разобрать CERTIFICATE_VERIFY_FAILED и найти причину |
Диагностика ошибок TLS |
| Задать минимальную версию TLS и обязательный HTTPS для исходящих запросов | Безопасность исходящих HTTP(S)-запросов |