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

**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](https://webim.ru/kb/devops/tls-certificates/troubleshooting.html).

Список хостов, до которых с сервера Webim должен быть сетевой доступ, приведён в статье [Необходимые доступы с сервера](https://webim.ru/kb/devops/accesses/accesses-from-server.html). Сетевой доступ и доверие к сертификату — разные условия: порт `443` может быть открыт, а TLS-рукопожатие всё равно не завершится.

## Канал MAX и сертификаты Минцифры РФ

Бэкенд [канала MAX](https://webim.ru/kb/channels/social-network-messengers/max.html) отвечает по `platform-api2.max.ru:443`. Сертификаты этого контура выпускает Национальный удостоверяющий центр Минцифры России (**Russian Trusted CA**). Их нет в стандартном наборе Debian и большинства других ОС, а также библиотеки `certifi`.

Без добавления этих УЦ **hosted**-установка не сможет обращаться к API канала MAX: сообщения не будут уходить и приниматься, в логах **Chat Backend** появится `CERTIFICATE_VERIFY_FAILED`.

То же относится к другим интеграциям, которые перешли (перейдут) на сертификаты Минцифры РФ или на корпоративный УЦ заказчика. Процедура одна, меняются только файлы УЦ.

### Какие файлы скачать

Скачивайте сертификаты только с официальной страницы Госуслуг РФ:

  * [Поддержка работы сайтов с российскими сертификатами](https://www.gosuslugi.ru/landing/tls)

  * [Сертификаты Минцифры](https://www.gosuslugi.ru/landing/crt)

Нужны 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`.

!!! Note "N.B."
    Установка корневого НУЦ Минцифры расширяет доверие ко **всем** цепочкам, которые на него опираются, а не только к MAX. Это ожидаемое следствие: так устроено системное хранилище CA.

### Установка на хост (без Docker)

Выполните общую процедуру из статьи [Добавление удостоверяющего центра](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#install-on-host): скопируйте оба `.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](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#install-in-docker). Настройка нужна **Chat Backend**: именно он ходит в API интеграций. Entrypoint бэкенда сам подхватит файл при старте.

Если исходящие HTTPS-запросы выполняет ещё и **Delta Proxy**, положите тот же файл и перезапустите его контейнер: `start.sh` импортирует УЦ при запуске, см. [Delta Proxy](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#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 с собственным УЦ (см. также [Интеграция с почтовыми сервисами](https://webim.ru/kb/devops/smtp-integration.html));

  * контроллер домена по LDAPS (см. [настройку LDAP](https://webim.ru/kb/devops/active-directory/ldap-configuration.html));

  * прокси, который подменяет сертификат (SSL inspection). В этом случае в доверенные нужно добавить УЦ **прокси**, а не исходного сайта;

  * **Delta Proxy**, если `ROOT_URL_FORMAT` открыт по HTTPS с нестандартным сертификатом. При запуске контейнера `start.sh` импортирует `/etc/webim/ssl/ca-certificates.crt`, см. [Delta Proxy](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#delta-proxy).

Не отключайте проверку сертификата в [настройках исходящих HTTP(S)-запросов](https://webim.ru/kb/devops/outgoing-http-tls.html).

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

  * [Канал MAX](https://webim.ru/kb/channels/social-network-messengers/max.html)

  * [Необходимые доступы с сервера](https://webim.ru/kb/devops/accesses/accesses-from-server.html)

  * [Добавление удостоверяющего центра](https://webim.ru/kb/devops/tls-certificates/adding-ca.html)

  * [Входящие соединения](https://webim.ru/kb/devops/tls-certificates/incoming.html)

  * [Диагностика ошибок TLS](https://webim.ru/kb/devops/tls-certificates/troubleshooting.html)

---

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