Неполная цепочка сертификатов: исправьте недостающий промежуточный элемент

Неполная цепочка сертификатов: как диагностировать и исправить отсутствующий промежуточный элемент (Nginx/Apache)
Прямой ответ: большинство «ошибок цепочки сертификатов» не являются недействительными сертификатами — сервер просто отправляет лист без своих промежуточных звеньев. Эту проблему решает одна команда: подсчитать сертификаты, возвращенные с помощью openssl s_client -showcerts; один сертификат означает разорванную цепочку. Исправление — это один объединенный файл, сначала лист, а затем промежуточные элементы: укажите на него Nginx ssl_certificate или в Apache 2.4.8+ поместите цепочку внутри цели SSLCertificateFile. Не отправляйте рут — он уже есть у клиентов.
Основные понятия
Три компонента
| Компонент | Роль | Должен ли сервер отправить его? |
|---|---|---|
| Leaf (конечный объект) | Привязывает ваше имя хоста | Да |
| Средний | Связывает лист с корнем | Да — отсутствие означает разрыв цепочки |
| Root | Якорь доверия клиента | Нет, уже в хранилище доверенных сертификатов |
Как работает цепочка
Клиенты напрямую доверяют корням. Ваш лист подписан промежуточным звеном, которого нет в его хранилище доверенных сертификатов, поэтому сервер должен отправить его во время рукопожатия, чтобы клиент построил лист → промежуточный → корень. Почему необходимо отправлять промежуточные соединения: клиенты доверяют только локальным корням; без промежуточных звеньев ни один путь не может быть построен.
Почему одни клиенты работают, а другие терпят неудачу
Некоторые клиенты кэшируют промежуточные данные или извлекают недостающее звено через расширение AIA; другие — старые версии Android, Java/OpenJDK, Curl, Node, агенты мониторинга — сразу же выходят из строя. Сервер никогда не должен полагаться на восстановление на стороне клиента: выборка AIA ненадежна, поскольку зависит от реализации клиента и доступности сети.
Порядок имеет значение
Сначала лист, затем промежуточные элементы в порядке подписи. Неправильный порядок ломает некоторых клиентов начисто.
Текущая иерархия Let's Encrypt
На практике ECDSA-лист отдаётся с ECDSA-промежуточным, но кросс-алгоритмная подпись допустима в X.509: совпадать должны издатель и подпись, а не тип ключа.
Исправьте это за 6 шагов
Шаг 1. Посмотрите, что на самом деле отправляет сервер
openssl s_client -connect example.com:443 -servername example.com -showcerts </dev/nullПодсчитайте блоки BEGIN CERTIFICATE: 1 означает только листовой; 2 и более – это здорово.
Шаг 2. Прочтите код подтверждения.
openssl s_client -connect example.com:443 -servername example.com -verify_return_error </dev/nullКод 20 = эмитент не найден (отсутствует промежуточный элемент); 21 = невозможно проверить первый сертификат; 19 = самоподписанный.
Шаг 3 — Получите правильное промежуточное звено
Получите правильное промежуточное звено из цепочки вашего ЦС или из расширения доступа к уполномоченной информации листа. Никогда не смешивайте поколения — листу ECDSA нужен промежуточный продукт ECDSA. Декодер сертификатов мгновенно показывает эмитента и AIA.
Шаг 4 — Объединение (сначала лист, без корня)
cat leaf.crt intermediate.crt > fullchain.crtНе добавляйте корень: он уже есть у клиентов в локальном хранилище доверенных сертификатов.
Шаг 5 — Настройте сервер
Nginx: есть только ssl_certificate и ssl_certificate_key; отдельной директивы цепочки не существует, поэтому промежуточные элементы должны находиться в одном файле, сначала листом.
ssl_certificate /etc/ssl/certs/fullchain.crt;
ssl_certificate_key /etc/ssl/private/example.com.key;Apache 2.4.8+: SSLCertificateChainFile удален; поместите цепочку в файл, на который ссылается SSLCertificateFile.
Пользователи Certbot: cert.pem — только листовой (его использование является основной причиной этой ошибки), Chain.pem — только промежуточный, а fullchain.pem — это то, что вы настраиваете.CDN: CDN завершает TLS своим собственным сертификатом; загрузка только листа пересылает посетителям ту же разорванную цепочку.
Шаг 6 — Проверка
openssl verify -CAfile root.pem -untrusted intermediate.pem leaf.pem # expect "leaf.pem: OK"Затем повторите внешнее тестирование с помощью SSL Checker и из чистого профиля браузера.
Контрольный список устранения неполадок
| Симптом/код | Значение | Исправить |
|---|---|---|
| ошибка проверки: номер=20 невозможно получить сертификат локального эмитента | Отсутствует промежуточный элемент или локально отсутствует корень | Проверьте, сколько сертификатов отправляет сервер |
| ошибка проверки: номер=21 невозможно проверить первый сертификат | Сервер не отправляет промежуточные данные | Постройте полную цепочку и перезагрузите |
| ошибка проверки: номер=19 самозаверяющий сертификат | Используется самозаверяющий сертификат | Переключиться на общедоступный сертификат |
| Chrome NET::ERR_CERT_AUTHORITY_INVALID | Ошибка построения пути | То же исправление, затем повторите тестирование с очищенным кешем |
| Не удалось построить путь Java PKIX | В TrustStore отсутствует центр сертификации или промежуточный продукт не возвращен | Отправить полную цепочку; не верьте "оно открывается в браузере" |
| curl / Node не работает, браузер работает | Браузер маскирует проблему | Считайте Curl основной истиной |
| Только некоторые устройства Android выходят из строя | Старое хранилище доверенных сертификатов, нет выборки AIA | Отправить всю цепочку |
| Промежуточный не подписывал лист | В файле цепочки не тот промежуточный | Отдавайте промежуточный, subject которого совпадает с issuer листа |
| Вы настроили cert.pem | Только Leaf, без промежуточных элементов | Переключиться на fullchain.pem |
| CDN/балансировщик нагрузки и источник расходятся во мнениях | Разные цепочки с каждой стороны | Обновить полную цепочку с обеих сторон |
Дальнейшее чтение
Инструменты: SSL Checker проверяет действующую цепочку · Certificate Decoder показывает эмитента и AIA · Certificate & Key Matcher также подтверждает сертификат и пару ключей
Связано: Объяснение форматов сертификатов SSL · Проверьте, соответствует ли сертификат своему секретному ключу · ACME HTTP-01 против DNS-01
Идите глубже: SSL-сертификаты: полное руководство · Сравнение типов сертификатов · Выбор сертификата SSL
Вопросы и ответы
Должен ли я включить корень в фулчейн?
Нет. У клиентов это уже есть; его отправка только добавляет байты и путаницу.
Почему Chrome работает, а Curl, Java или Android не работают?
Некоторые клиенты кэшируют промежуточные данные или извлекают их через AIA; другие этого не делают. Судите по завитку, а не по вашему браузеру.
Скрывает ли это CDN?
Нет. CDN завершает TLS с помощью собственного сертификата, поэтому при загрузке только листа разорванная цепочка передается посетителям.
В чем разница между cert.pem, Chain.pem и Fullchain.pem?
В каталоге Certbot: cert.pem — только листовой, Chain.pem — только промежуточные, Fullchain.pem — листовой + промежуточные. Используйте fullchain.pem в Nginx/Apache.
Что мне нужно делать с новыми корнями Let’s Encrypt?
Обычно ничего вручную — клиенты получают новую цепочку автоматически. Просто убедитесь, что никакая конфигурация не закрепляет конкретное промежуточное звено и что хранилища доверенных сертификатов старых клиентов содержат корень ISRG X1/X2.
Бесплатные SSL/TLS инструменты
Проверяйте сертификаты за секунды.
Информация о сертификатах
Подробнее о выборе и покупке SSL-сертификатов.