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

В hosted-контуре перед **Webim Server** часто стоит балансировщик, WAF и/или reverse-прокси (обычно, в DMZ). На нём размещают сертификат **внешнего** домена, через который заходят как посетители, так и операторы. Балансировщик расшифровывает входящий трафик и пересылает его внутри сети заказчика на **Webim Server** (обычно, в закрытый LAN).

На самом сервере Webim при этом может быть другой, внутренний домен и **нестандартный** сертификат: самоподписной или выпущенный корпоративным УЦ, которого нет в системном наборе Debian.

```
Посетитель / оператор
        │  HTTPS, сертификат внешнего домена
        ▼
Балансировщик (chat.example.local)
        │  HTTP или HTTPS внутри сети
        ▼
Webim Server (webim.internal.local)
```

Для клиентов снаружи важен только сертификат балансировщика. Дополнительные действия на **Webim Server** нужны, когда:

  * на внутреннем участке используется HTTPS с нестандартным сертификатом;

  * **Webim Server** сам обращается к своему домену по HTTPS и видит нестандартный сертификат (типичный случай — split-horizon DNS: снаружи и изнутри одно имя отдаёт разные сертификаты);

  * в файле сертификата нет промежуточного УЦ, и проверка цепочки не сходится даже при «обычном» УЦ.

## Что должно быть на внешнем контуре

Домен, который указан в конфигурации Webim как `base_domain` и по которому открывают виджет, РМО и API, должен соответствовать [требованиям к доменному имени](https://webim.ru/kb/devops/sys-reqs-for-server/sys-reqs-server-nw.html#domain-name-requirements).

Сертификат **этого** домена на узле, который видят браузеры и мобильные приложения, должен быть действительным и доверенным для этих клиентов. Если выставить самоподписной сертификат сразу на внешнем домене, посетители и мобильные приложения получат ошибку в своём TLS-стеке — это нельзя исправить настройками **Webim Server**.

Рекомендуемая схема:

  * на балансировщике — сертификат внешнего домена от УЦ, которому доверяют браузеры и устройства пользователей;

  * внутри сети — HTTP либо HTTPS с внутренним сертификатом, к которому настроено доверие на сервере Webim.

## Полная цепочка в файле сертификата

И на балансировщике, и на **nginx** Webim файл сертификата должен содержать **листовой** сертификат и все **промежуточные** УЦ. Корневой УЦ в этот файл обычно не кладут: его добавляют в хранилище доверенных, см. [Добавление удостоверяющего центра](https://webim.ru/kb/devops/tls-certificates/adding-ca.html).

Типичный порядок блоков PEM:

```
-----BEGIN CERTIFICATE-----
листовой (конечный) сертификат домена
-----END CERTIFICATE-----
-----BEGIN CERTIFICATE-----
промежуточный УЦ
-----END CERTIFICATE-----
```

Если промежуточного блока нет, клиент (в том числе сам **Webim Server**, `openssl` и библиотеки Python) часто отвечает:

```
ssl.SSLCertVerificationError: [SSL: CERTIFICATE_VERIFY_FAILED]
certificate verify failed: unable to get local issuer certificate
```

По этому тексту нельзя сразу понять, чего не хватает: промежуточного блока в файле, корневого CA на клиенте или чего-то ещё. Как различить причины — в статье [Диагностика ошибок TLS](https://webim.ru/kb/devops/tls-certificates/troubleshooting.html).

Проверьте, сколько сертификатов в файле, который отдаёт сервер:

```
echo | openssl s_client -connect webim.internal.example.local:443 \
  -servername webim.internal.example.local -showcerts 2>/dev/null \
  | grep -c 'BEGIN CERTIFICATE'
```

Значение `1` при том, что издатель листа не является общеизвестным корневым УЦ, почти всегда означает оборванную цепочку.

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

На хосте HTTPS для **Webim** обычно принимает **nginx**. Путь к конфигу зависит от установки, часто это:

```
/etc/nginx/sites-available/webim-hosted.conf
```

  1. Положите листовой сертификат с промежуточными УЦ и закрытый ключ в каталог, доступный **nginx**, например `/etc/nginx/ssl/`. Закрытый ключ не должен быть доступен лишним пользователям:

    ```
    sudo install -d -m 0750 /etc/nginx/ssl
    sudo install -m 0644 webim-fullchain.crt /etc/nginx/ssl/webim.crt
    sudo install -m 0640 webim.key /etc/nginx/ssl/webim.key
    ```

  1. В конфиге **nginx** укажите эти файлы в директивах `ssl_certificate` и `ssl_certificate_key` (имена директив и путь к конфигу возьмите из сборки).

  1. Проверьте конфиг и перечитайте настройки **nginx**:

    ```
    sudo nginx -t
    sudo systemctl reload nginx
    ```

  1. Если сертификат самоподписной или выпущен корпоративным УЦ, [добавьте этот УЦ](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#install-on-host) в доверенные на том же хосте и перезапустите службы **Webim**:

    ```
    sudo systemctl restart webim-tornado
    sudo systemctl restart webim-admin-backend
    ```

    Это нужно не балансировщику снаружи, а процессам **Webim**, которые сами открывают HTTPS к `base_domain` или к внутреннему имени.

  1. С хоста проверьте, что имя из сертификата совпадает с тем, к которому подключаются, и что проверка проходит:

    ```
    echo | openssl s_client -connect webim.internal.example.local:443 \
      -servername webim.internal.example.local -verify_return_error
    ```

    Успех — `Verify return code: 0 (ok)`.

## Установка в Docker {: #install-in-docker }

В типовой поставке **nginx** работает в контейнере образа `webim_nginx`. Каталог `/etc/webim` уже смонтирован в этот контейнер. Пути к сертификату и ключу **заданы в образе** (`webim-hosted-https.conf`) и не настраиваются в `docker-compose`:

```
ssl_certificate     /etc/webim/ssl/server.crt;
ssl_certificate_key /etc/webim/ssl/server.key;
```

Отдельные тома с другими путями не нужны: достаточно положить файлы на хост в эти имена.

  1. Положите полную цепочку и закрытый ключ на хост:

    ```
    sudo install -d -m 0750 /etc/webim/ssl
    sudo install -m 0644 webim-fullchain.crt /etc/webim/ssl/server.crt
    sudo install -m 0640 webim.key /etc/webim/ssl/server.key
    ```

  1. Перечитайте конфигурацию **nginx** в контейнере (или перезапустите сервис `nginx` из `/etc/webim/docker-compose.yml`).

  1. Если внутренний сертификат нестандартный, [добавьте УЦ](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#install-in-docker) для бэкендов — файл `/etc/webim/ssl/ca-certificates.crt`. Это другой файл, не `server.crt`. УЦ нужны контейнерам, которые делают исходящие запросы по HTTPS, то есть **Chat Backend**, **Admin Backend**, **History Backend**. Если в поставке используется **Delta Proxy**, положите тот же файл и перезапустите его контейнер: `start.sh` импортирует УЦ при запуске, см. [Delta Proxy](https://webim.ru/kb/devops/tls-certificates/adding-ca.html#delta-proxy).

  1. Проверку `openssl s_client` выполняйте из того окружения, где работает клиент: с хоста — если к внутреннему HTTPS ходит хост; из контейнера — если ходит процесс Webim:

    ```
    docker compose -f /etc/webim/docker-compose.yml exec chat_backend \
      openssl s_client -connect webim.internal.example.local:443 \
      -servername webim.internal.example.local -verify_return_error
    ```

## Когда внутренний участок работает по HTTP

Если балансировщик расшифровывает HTTPS и пересылает запрос на **Webim Server** уже по HTTP, на самом Webim серверный сертификат для этого участка не нужен. Ошибка `CERTIFICATE_VERIFY_FAILED` в таком контуре почти никогда не связана с «входящим» сертификатом Webim: ищите [исходящее](https://webim.ru/kb/devops/tls-certificates/outgoing.html) соединение (канал, CRM, SMTP) либо обращение **Webim** к собственному `base_domain` по HTTPS.

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

  * [Требования к сетевым настройкам](https://webim.ru/kb/devops/sys-reqs-for-server/sys-reqs-server-nw.html)

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

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

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

---

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