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

Исходящие соединения

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

Связанные статьи