Входящие соединения
В 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
-
Положите листовой сертификат с промежуточными УЦ и закрытый ключ в каталог, доступный 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 -
В конфиге nginx укажите эти файлы в директивах
ssl_certificateиssl_certificate_key(имена директив и путь к конфигу возьмите из сборки). -
Проверьте конфиг и перечитайте настройки nginx:
sudo nginx -t sudo systemctl reload nginx -
Если сертификат самоподписной или выпущен корпоративным УЦ, добавьте этот УЦ в доверенные на том же хосте и перезапустите службы Webim:
sudo systemctl restart webim-tornado sudo systemctl restart webim-admin-backendЭто нужно не балансировщику снаружи, а процессам Webim, которые сами открывают HTTPS к
base_domainили к внутреннему имени. -
С хоста проверьте, что имя из сертификата совпадает с тем, к которому подключаются, и что проверка проходит:
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;
Отдельные тома с другими путями не нужны: достаточно положить файлы на хост в эти имена.
-
Положите полную цепочку и закрытый ключ на хост:
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 -
Перечитайте конфигурацию nginx в контейнере (или перезапустите сервис
nginxиз/etc/webim/docker-compose.yml). -
Если внутренний сертификат нестандартный, добавьте УЦ для бэкендов — файл
/etc/webim/ssl/ca-certificates.crt. Это другой файл, неserver.crt. УЦ нужны контейнерам, которые делают исходящие запросы по HTTPS, то есть Chat Backend, Admin Backend, History Backend. Если в поставке используется Delta Proxy, положите тот же файл и перезапустите его контейнер:start.shимпортирует УЦ при запуске, см. Delta Proxy. -
Проверку
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.