Исходящие соединения
Webim Server сам устанавливает HTTPS-соединения к внешним системам: каналам общения, CRM, почтовым и push-сервисам, внутренним системам заказчика. Проверку сертификата в таких запросах нельзя обойти «настройкой входящего HTTPS»: здесь сертификат предъявляет удалённая сторона, а Webim выступает клиентом.
Если УЦ этой стороны нет ни в системном наборе серверной ОС, ни в пакете Python certifi, запрос завершится ошибкой вида:
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: unable to get local issuer certificate (_ssl.c:1091)
Текст не говорит, какой именно УЦ отсутствует и в каком хранилище его искать. Разбор — в статье Диагностика ошибок TLS.
Список хостов, до которых с сервера Webim должен быть сетевой доступ, приведён в статье Необходимые доступы с сервера. Сетевой доступ и доверие к сертификату — разные условия: порт 443 может быть открыт, а TLS-рукопожатие всё равно не завершится.
Канал MAX и сертификаты Минцифры РФ
Бэкенд канала MAX отвечает по platform-api2.max.ru:443. Сертификаты этого контура выпускает Национальный удостоверяющий центр Минцифры России (Russian Trusted CA). Их нет в стандартном наборе Debian и большинства других ОС, а также библиотеки certifi.
Без добавления этих УЦ hosted-установка не сможет обращаться к API канала MAX: сообщения не будут уходить и приниматься, в логах Chat Backend появится CERTIFICATE_VERIFY_FAILED.
То же относится к другим интеграциям, которые перешли (перейдут) на сертификаты Минцифры РФ или на корпоративный УЦ заказчика. Процедура одна, меняются только файлы УЦ.
Какие файлы скачать
Скачивайте сертификаты только с официальной страницы Госуслуг РФ:
Нужны PEM-файлы:
-
Russian Trusted Root CA — корневой (
russian_trusted_root_ca_pem.crt); -
Russian Trusted Sub CA — выпускающий, промежуточный (
russian_trusted_sub_ca_pem.crt).
Для проверки HTTPS обычно достаточно корневого УЦ, если сервер MAX отдаёт промежуточный в цепочке. На практике надёжнее установить оба файла: так проверка не зависит от того, прислал ли удалённый сервер промежуточный сертификат.
Проверьте, что файлы в формате PEM и что промежуточный подтверждается корневым:
openssl x509 -inform PEM -in russian_trusted_root_ca_pem.crt -noout -subject -issuer -dates
openssl x509 -inform PEM -in russian_trusted_sub_ca_pem.crt -noout -subject -issuer -dates
openssl verify -CAfile russian_trusted_root_ca_pem.crt russian_trusted_sub_ca_pem.crt
Ожидаемый результат второй проверки: russian_trusted_sub_ca_pem.crt: OK.
N.B.
Установка корневого НУЦ Минцифры расширяет доверие ко всем цепочкам, которые на него опираются, а не только к MAX. Это ожидаемое следствие: так устроено системное хранилище CA.
Установка на хост (без Docker)
Выполните общую процедуру из статьи Добавление удостоверяющего центра: скопируйте оба .crt в /usr/local/share/ca-certificates/webim/ (или в отдельный каталог russian-trusted), запустите update-ca-certificates, задайте переменные SSL_CERT_FILE и REQUESTS_CA_BUNDLE службам Webim и перезапустите их.
Проверка с хоста:
echo | openssl s_client -connect platform-api2.max.ru:443 \
-servername platform-api2.max.ru -verify_return_error
Проверка интерпретатором Python (используйте именно то окружение, в котором установлен Webim Chat Backend):
cd /opt/webim/envs/eta/chat_backend.venv/bin
source activate
python3 -c "import requests; r = requests.get('https://platform-api2.max.ru', timeout=10); print(r.status_code)"
Успех — рукопожатие без CERTIFICATE_VERIFY_FAILED (код ответа HTTP при этом может быть не 200: проверяется именно TLS). Если openssl уже проходит, а requests — нет, библиотека всё ещё читает certifi. Вернитесь к переменным окружения процесса Webim.
Установка в Docker
Объедините PEM-файлы Минцифры в /etc/webim/ssl/ca-certificates.crt на хосте и перезапустите контейнеры бэкендов по инструкции Добавление удостоверяющего центра в Docker. Настройка нужна Chat Backend: именно он ходит в API интеграций. Entrypoint бэкенда сам подхватит файл при старте.
Если исходящие HTTPS-запросы выполняет ещё и Delta Proxy, положите тот же файл и перезапустите его контейнер: start.sh импортирует УЦ при запуске, см. Delta Proxy.
Проверка из контейнера (пример для MAX):
docker compose -f /etc/webim/docker-compose.yml exec chat_backend \
openssl s_client -connect platform-api2.max.ru:443 \
-servername platform-api2.max.ru -verify_return_error
docker compose -f /etc/webim/docker-compose.yml exec chat_backend \
/opt/webim/envs/eta/chat_backend/bin/python -c \
"import requests; r = requests.get('https://platform-api2.max.ru', timeout=10); print(r.status_code)"
После смены образа бэкендов и Delta Proxy файл /etc/webim/ssl/ca-certificates.crt на хосте остаётся на месте, и скрипт запуска применит его снова.
Другие исходящие интеграции
Ту же схему применяют, если недоверенный сертификат предъявляет не бэкенд интегрированного канала, а сервера других интеграций:
-
обработчики событий чата, CRM или внешний бот;
-
SMTP/IMAP с собственным УЦ (см. также Интеграция с почтовыми сервисами);
-
контроллер домена по LDAPS (см. настройку LDAP);
-
прокси, который подменяет сертификат (SSL inspection). В этом случае в доверенные нужно добавить УЦ прокси, а не исходного сайта;
-
Delta Proxy, если
ROOT_URL_FORMATоткрыт по HTTPS с нестандартным сертификатом. При запуске контейнераstart.shимпортирует/etc/webim/ssl/ca-certificates.crt, см. Delta Proxy.
Не отключайте проверку сертификата в настройках исходящих HTTP(S)-запросов.