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

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

В 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, должен соответствовать требованиям к доменному имени.

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

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

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

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

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

И на балансировщике, и на nginx Webim файл сертификата должен содержать листовой сертификат и все промежуточные УЦ. Корневой УЦ в этот файл обычно не кладут: его добавляют в хранилище доверенных, см. Добавление удостоверяющего центра.

Типичный порядок блоков 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.

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

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
    
  2. В конфиге nginx укажите эти файлы в директивах ssl_certificate и ssl_certificate_key (имена директив и путь к конфигу возьмите из сборки).

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

    sudo nginx -t
    sudo systemctl reload nginx
    
  4. Если сертификат самоподписной или выпущен корпоративным УЦ, добавьте этот УЦ в доверенные на том же хосте и перезапустите службы Webim:

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

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

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

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

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

Установка в 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
    
  2. Перечитайте конфигурацию nginx в контейнере (или перезапустите сервис nginx из /etc/webim/docker-compose.yml).

  3. Если внутренний сертификат нестандартный, добавьте УЦ для бэкендов — файл /etc/webim/ssl/ca-certificates.crt. Это другой файл, не server.crt. УЦ нужны контейнерам, которые делают исходящие запросы по HTTPS, то есть Chat Backend, Admin Backend, History Backend. Если в поставке используется Delta Proxy, положите тот же файл и перезапустите его контейнер: start.sh импортирует УЦ при запуске, см. Delta Proxy.

  4. Проверку 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: ищите исходящее соединение (канал, CRM, SMTP) либо обращение Webim к собственному base_domain по HTTPS.

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