Эта проблема часто проявляется коварно. Владелец сайта устанавливает новый сертификат, открывает сайт в Chrome на компьютере, видит замок и успокаивается. А через несколько дней клиенты сообщают, что на телефоне сайт помечен как небезопасный, мобильное приложение не подключается к серверу или перестали приходить уведомления платёжной системы. Сервисы проверки SSL показывают предупреждение «Chain issues: Incomplete» или «Extra download». Причина у всего этого одна: на сервере не хватает промежуточного сертификата.
Как устроена цепочка сертификатов
Удостоверяющие центры не подписывают сертификаты сайтов напрямую своим корневым сертификатом. Корневой ключ слишком ценен, поэтому он хранится в защищённом месте и используется только для подписи промежуточных сертификатов. Сертификат вашего сайта подписывает именно промежуточный. В итоге цепочка состоит из трёх звеньев: сертификат сайта, промежуточный и корневой. Корневые сертификаты заранее встроены в операционные системы и браузеры, а промежуточные — нет, поэтому их обязан отправлять сервер.
Если сервер отправляет только сертификат сайта, устройство клиента не может найти промежуточный сертификат, которым он подписан, и не может связать цепочку до корня. В результате сертификат признаётся недоверенным, хотя сам по себе он совершенно правильный.
Почему ошибка появляется только на некоторых устройствах
Найти проблему мешает то, что настольные браузеры часто её скрывают. Некоторые браузеры читают адрес промежуточного сертификата из поля AIA внутри сертификата и сами его скачивают. Другие хранят в кеше промежуточные сертификаты, встреченные ранее на других сайтах. Поэтому один и тот же сайт работает на вашем компьютере, но выдаёт ошибку на новом телефоне, старом Android-устройстве или в другом браузере.
Программы такой «помощи» не оказывают. curl, Python, PHP, Java и мобильные приложения обычно опираются только на цепочку, которую прислал сервер. Поэтому первыми ломаются связи сервер-сервер: API, вебхуки и уведомления платёжных систем. Например, интернет-магазин цветов в Ташкенте может перестать принимать подтверждения от платёжной системы, потому что её сервер не может проверить сертификат сайта магазина. Заказы оплачены, а на сайте числятся неоплаченными.
Как выявить проблему
Самая надёжная проверка — подключиться к серверу через OpenSSL и посмотреть, сколько сертификатов он отправляет. На правильно настроенном сервере в списке минимум два сертификата: в строке 0 s: ваш сайт, в строке 1 s: промежуточный. Если виден только сертификат с номером 0, а код результата не 0, а 20 или 21, цепочка неполная.
echo | openssl s_client -connect example.uz:443 -servername example.uz -showcerts 2>/dev/null \
| grep -E '^ *[0-9] s:|i:|Verify return code'
# Если цепочка неполная:
# 0 s:CN = example.uz
# i:C = US, O = Let's Encrypt, CN = R11
# Verify return code: 21 (unable to verify the first certificate)
Ту же проблему покажет и curl. В отличие от браузера, он не скачивает промежуточный сертификат сам, поэтому хорошо отражает то, что происходит при связи сервер-сервер.
curl -sS -o /dev/null https://example.uz/
# curl: (60) SSL certificate problem: unable to get local issuer certificate
Подготовка файла полной цепочки
При получении сертификата от удостоверяющего центра обычно выдаётся несколько файлов: сертификат сайта и промежуточный сертификат или файл с названием «CA bundle». Для полной цепочки их нужно объединить в один файл. Порядок важен: сначала сертификат сайта, затем промежуточные. Корневой добавлять не нужно: он уже есть на устройстве клиента и кроме лишнего объёма ничего не даст.
cat example.uz.crt intermediate.crt > fullchain.crt
grep -c 'BEGIN CERTIFICATE' fullchain.crt
openssl verify -untrusted intermediate.crt example.uz.crt
Вторая команда показывает, сколько сертификатов в файле, а третья проверяет, что сертификат сайта действительно подписан этим промежуточным. Если после объединения пропал перевод строки и сертификаты склеились в строку вида -----END CERTIFICATE----------BEGIN CERTIFICATE-----, добавьте между ними перевод строки, иначе веб-сервер не сможет прочитать файл.
Исправление в Nginx
В Nginx нет отдельного параметра для цепочки: файл, указанный в ssl_certificate, должен содержать и сертификат сайта, и промежуточные. Самая частая ошибка именно здесь: в этом параметре указан файл только с сертификатом сайта. Замените его файлом полной цепочки, проверьте конфигурацию и перезагрузите Nginx.
server {
listen 443 ssl;
server_name example.uz www.example.uz;
ssl_certificate /etc/ssl/example.uz/fullchain.crt;
ssl_certificate_key /etc/ssl/example.uz/private.key;
}
sudo nginx -t && sudo systemctl reload nginx
Исправление в Apache
В Apache 2.4.8 и новее, как и в Nginx, рекомендуется указывать файл полной цепочки в параметре SSLCertificateFile. В старых версиях промежуточный сертификат подключается отдельно через SSLCertificateChainFile. В новых версиях этот параметр считается устаревшим, но по-прежнему работает.
# Apache 2.4.8 и новее
SSLCertificateFile /etc/ssl/example.uz/fullchain.crt
SSLCertificateKeyFile /etc/ssl/example.uz/private.key
# Старые версии Apache
SSLCertificateFile /etc/ssl/example.uz/example.uz.crt
SSLCertificateChainFile /etc/ssl/example.uz/intermediate.crt
Файлы Certbot и Let's Encrypt
Certbot создаёт несколько файлов, и в них легко запутаться. На вручную настроенных серверах часто указан cert.pem, а это как раз неполная цепочка. Веб-серверу всегда нужно подключать fullchain.pem.
# Файлы Certbot
/etc/letsencrypt/live/example.uz/cert.pem # только сертификат сайта
/etc/letsencrypt/live/example.uz/chain.pem # только промежуточный
/etc/letsencrypt/live/example.uz/fullchain.pem # правильный выбор
/etc/letsencrypt/live/example.uz/privkey.pem # закрытый ключ
Установка сертификата в панели хостинга
Если ваш сайт размещён на хостинге sayt.uz и сертификат Let's Encrypt выпущен через панель, цепочка устанавливается автоматически и эта проблема обычно не возникает. При ручной загрузке коммерческого сертификата в панели есть отдельные поля для сертификата, закрытого ключа и цепочки. Вставьте текст промежуточного сертификата или CA bundle именно в поле цепочки и не оставляйте его пустым. После установки проверьте командой OpenSSL выше, что код результата равен 0. Если возникнут трудности, обратитесь в техподдержку из кабинета sayt.uz.
Что проверить после исправления
После исправления цепочки повторите проверку не только в браузере своего компьютера, но и через curl или OpenSSL: кеш браузера может снова ввести вас в заблуждение. Если тот же сертификат использует почтовый сервер, проверьте и порты 465 и 993, они часто настраиваются отдельно. Убедитесь, что при следующем продлении сертификат снова будет установлен с полной цепочкой, иначе через год проблема вернётся.