Сообщение `invalidUrl` у Viber не означает автоматически «просрочен сертификат». При установке webhook платформа сначала должна разрешить домен, установить HTTPS-соединение, проверить доверие к сертификату и получить от endpoint ответ `200 OK`. Разложите одну попытку по этим этапам: так становится видно, оборвалась ли она до reverse proxy или уже дошла до приложения.
У webhook должен быть публичный HTTPS-адрес с сертификатом от доверенного центра. Самоподписанный сертификат Viber не принимает. В актуальной документации сервиса также указано требование TLS 1.2 или новее. Не ослабляйте TLS и не отключайте проверку сертификата: это не исправляет запросы Viber и создаёт отдельную уязвимость.
Ответ теста указывает на конкретный слой
| Наблюдение | Где искать | Что подтвердить |
|---|---|---|
| DNS не разрешается | публичная зона DNS | A/AAAA ведут на действующий proxy |
| TLS alert до HTTP | сертификат и протоколы | имя, срок, цепочка, TLS 1.2+ |
| в access log нет запроса | firewall, CDN, SNI | порт 443 доступен извне |
| Viber получает не 200 | route и middleware | callback не перенаправлен на login или 404 |
| 200 приходит слишком поздно | синхронная логика | подтверждение отделено от тяжёлой обработки |
Проверяйте с внешнего узла, а не только с самого сервера. Локальный `curl` может использовать внутренний DNS, обходить CDN или доверять корпоративному CA. Для IPv6 отдельно убедитесь, что AAAA-запись ведёт на работающий endpoint: часть клиентов выберет её, даже если IPv4 настроен верно.
Цепочка должна включать промежуточные сертификаты
Сервер отправляет leaf-сертификат домена и необходимые промежуточные сертификаты. Корневой сертификат обычно уже находится в trust store клиента и не заменяет intermediate. Типичная ошибка: браузер достраивает цепочку из своего кэша, а новый серверный клиент видит только leaf и не может прийти к доверенному корню.
openssl s_client -connect bot.example.com:443 \
-servername bot.example.com -showcerts
# затем отдельная проверка HTTP без секретного token
curl -i https://bot.example.com/viber/webhook- Имя в URL должно входить в SAN сертификата; сертификат только для другого поддомена не подходит.
- Проверьте notBefore/notAfter и часы сервера, но не публикуйте приватный ключ или authentication token.
- На виртуальном хосте должен выбираться нужный сертификат по SNI, а не сертификат сайта по умолчанию.
- После обновления сертификата проверьте именно публичный адрес через CDN или балансировщик.
Проверочный callback обязан вернуть обычный 200
После вызова `set_webhook` Viber отправляет событие `webhook` на указанный URL. Проверка считается успешной, когда сервер получает HTTP 200; редирект, страница авторизации, 403 от WAF, 404 из-за завершающего слеша и 5xx считаются ошибкой. Создайте точный route для POST и проверьте, что middleware не требует cookie браузера и не пытается разобрать событие как пользовательское сообщение.
Подтверждение должно быть коротким: принять тело, выполнить минимальную валидацию, записать request ID и вернуть 200. Если callback запускает обращение к CRM, генерацию ответа или долгую транзакцию до отправки статуса, доступный endpoint может выглядеть недоступным из-за тайм-аута. Работу после приёма переносите в очередь с идемпотентным ключом.
Логи связывают set_webhook и входящий запрос
Для одной попытки сохраните время UTC, домен, итог `set_webhook` со `status` и `status_message`, TLS-ошибку на proxy, HTTP status и длительность callback. Тело пользовательских сообщений и token в журнал не нужны. Callback от Viber содержит подпись: её проверяют HMAC-SHA256 по исходному JSON с token аккаунта как ключом, сравнивая результат безопасным способом.
- Отправить set_webhook и записать ответ API без authentication token.
- Найти входящий POST в CDN, reverse proxy и приложении по времени.
- Если POST отсутствует, исследовать DNS, TLS и сетевую доступность.
- Если POST есть, сверить route, подпись, status и время ответа.
- Повторить проверку снаружи после исправления, не меняя сразу несколько слоёв.
Готовность проверяется после продления сертификата
Автоматическое продление считается рабочим только после reload процесса, который обслуживает TLS. Полезный тест — сравнить serial и срок сертификата на диске с тем, что реально отдаёт публичный hostname. Если сертификат завершается на CDN, обновление файла в origin вообще не меняет внешний ответ; владелец сертификата должен быть определён явно.
Итоговый критерий прост: внешний клиент строит доверенную цепочку для точного hostname, согласует TLS 1.2+, POST `webhook` достигает нужного route, получает быстрый 200, а ответ `set_webhook` содержит `status: 0`. После этого отдельно тестируют подписанный message callback и повторную доставку; SSL уже не смешивают с логикой бота.