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

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)-запросов