Проверяем SSL-сертификат по списку хостов: срок, цепочка и имя
Срок у сертификата не вышел, а клиент на соседнем сервере обрывается на unable to get local issuer certificate. Ничего странного: за словами «проверить сертификат» стоят три разные проверки. Не истёк ли срок. Собирается ли цепочка до корня, которому машина доверяет. Выдан ли сертификат на то имя, по которому к сервису обращаются. Разные инструменты отвечают на разный набор этих вопросов, а до отказа доходит только самая строгая проверка.
Дальше собирается стенд из публичных хостов, где TLS сломан специально, руками через openssl разбираются отказы четырёх видов, а потом всё складывается в скрипт на стандартной библиотеке Python: он проходит список хостов с портами и отдаёт код возврата для планировщика. TLS — протокол, который шифрует соединение и предъявляет клиенту сертификат сервера; SSL это его прежнее название, так что «SSL-сертификат» и «TLS-сертификат» означают одно и то же.
Всё, что ниже, прогонялось на Linux с OpenSSL 3.5.5 и Python 3.14. Тексты сообщений OpenSSL от сборки к сборке отличаются, так что дословного совпадения строк ждать не стоит; смысл кодов при этом тот же.
Стенд из хостов, у которых TLS сломан специально
Ломать собственный сервер ради эксперимента не нужно. Проект badssl.com держит набор поддоменов, у каждого из которых TLS испорчен своим способом, и они открыты для всех. Берутся четыре из них, а пятым в список идёт сам badssl.com без поддомена — исправный образец, с которым сравнивается остальное:
expired.badssl.com— срок действия сертификата вышел;wrong.host.badssl.com— сертификат выдан на другое имя;self-signed.badssl.com— сертификат подписан сам собой, без удостоверяющего центра, то есть организации, чьему корневому сертификату машина читателя доверяет по умолчанию;incomplete-chain.badssl.com— сервер не отдаёт промежуточный сертификат, звено между сертификатом сайта и корневым сертификатом удостоверяющего центра.
Корневые сертификаты лежат на машине клиента в отдельном хранилище (в Debian и Ubuntu это каталог /etc/ssl/certs из пакета ca-certificates), сертификат сайта приходит с сервера, а всё, что между ними, сервер обязан прислать сам. Не прислал — цепочку до корня выстроить не из чего.
Первый заход — проверка всех пяти адресов подряд. Работает s_client, тестовый TLS-клиент из состава openssl: он подключается к хосту и печатает подробности соединения.
for h in badssl.com expired.badssl.com wrong.host.badssl.com \
incomplete-chain.badssl.com self-signed.badssl.com; do
printf "%-30s " "$h"
openssl s_client -connect $h:443 -servername $h </dev/null 2>/dev/null \
| grep "Verify return code"
done
Флаг -servername передаёт имя в SNI (Server Name Indication) — расширение TLS, которым клиент в самом начале сообщает, к какому именно сайту он пришёл. Без него сервер, где на одном адресе живёт несколько сайтов, отдаст сертификат по умолчанию, и проверен будет чужой сертификат. Вывод команды:
badssl.com Verify return code: 0 (ok)
expired.badssl.com Verify return code: 10 (certificate has expired)
wrong.host.badssl.com Verify return code: 0 (ok)
incomplete-chain.badssl.com Verify return code: 21 (unable to verify the first certificate)
self-signed.badssl.com Verify return code: 18 (self-signed certificate)
Код 10 — просроченный сертификат, 18 — самоподписанный, 21 — оборванная цепочка. А вот wrong.host.badssl.com с заведомо чужим именем получил ноль, то есть «всё в порядке».
Что теряется при проверке по одной дате
Что стоит за словами «оборванная цепочка», видно, если попросить у сервера все сертификаты, которые он присылает, и просто их сосчитать. Флаг -showcerts печатает их целиком, дальше считаются строки-заголовки:
for h in badssl.com incomplete-chain.badssl.com; do
printf "%-30s " "$h"
openssl s_client -connect $h:443 -servername $h -showcerts </dev/null 2>/dev/null \
| grep -c "BEGIN CERTIFICATE"
done
badssl.com 3
incomplete-chain.badssl.com 1
Исправный хост присылает три сертификата: свой и два звена в сторону корня. Сломанный — один, свой собственный. Достраивать цепочку не из чего.
Теперь тот же сломанный хост проверяется привычным способом, по дате. Срок хранится в поле notAfter — это дата, после которой сертификат недействителен.
echo | openssl s_client -connect incomplete-chain.badssl.com:443 \
-servername incomplete-chain.badssl.com 2>/dev/null \
| openssl x509 -noout -enddate -subject
Здесь два инструмента соединены конвейером: s_client печатает полученный сертификат в текстовом виде, а openssl x509 его разбирает, причём флаг -noout убирает из вывода сам сертификат и оставляет только запрошенные поля. Пустой ввод от echo нужен, чтобы s_client не ждал, пока в него что-нибудь напечатают. Разбирает x509 только первый сертификат из потока — тот самый единственный, который есть и у сломанного хоста:
notAfter=Oct 26 20:03:01 2026 GMT
subject=CN=*.badssl.com
Дата настоящая, на день прогона до истечения оставалось около двух месяцев, имя выглядит правильным. Теперь тот же адрес обычным клиентом:
curl -sS -o /dev/null https://incomplete-chain.badssl.com/ 2>&1 | head -1
curl: (60) SSL certificate OpenSSL verify result: unable to get local issuer certificate (20)
Коды разные, поломка одна. s_client сказал 21, unable to verify the first certificate: первый сертификат нечем проверить. curl говорит 20, unable to get local issuer certificate: издателя нет в локальном хранилище. Обе строки про одно и то же — звена между сертификатом сайта и корнем нет ни в ответе сервера, ни на машине.
Адрес, по которому недостающее звено лежит у самого удостоверяющего центра, записан внутри сертификата, в расширении AIA (Authority Information Access). Его видно тем же конвейером:
openssl s_client -connect incomplete-chain.badssl.com:443 \
-servername incomplete-chain.badssl.com </dev/null 2>/dev/null \
| openssl x509 -noout -text | grep -A1 "Authority Information Access"
Authority Information Access:
CA Issuers - URI:http://yr2.i.lencr.org/
Дальше клиенты расходятся. Chromium по этой ссылке ходит: докачка недостающего звена встроена в построение цепочки. Firefox по ней не ходит — запрос на такое поведение закрыт как WONTFIX из-за приватности, потому что поход по ссылке из непроверенного сертификата выдаёт факт визита; вместо этого Firefox заранее подгружает список промежуточных сертификатов из общей базы удостоверяющих центров, и открытие такого сайта зависит от того, попало ли нужное звено в этот список. curl не делает ни того, ни другого — отсюда ошибка выше.
Скрипт из раздела ниже написан на стандартной библиотеке Python и на этом хосте отказывает так же, как curl. А проверка, которая читает одно поле notAfter, про такой отказ не скажет ничего: разбор доходит только до первого сертификата, а 2>/dev/null в команде с датой убирает диагностику.
openssl по умолчанию не сверяет имя хоста
Ноль у wrong.host.badssl.com получился не по ошибке: s_client проверяет подпись и цепочку, а сверку имени включают отдельным флагом.
openssl s_client -connect wrong.host.badssl.com:443 \
-servername wrong.host.badssl.com \
-verify_hostname wrong.host.badssl.com </dev/null 2>/dev/null \
| grep -E "Verify return code|^subject="
subject=CN=*.badssl.com
Verify return code: 62 (hostname mismatch)
Сертификат живой, цепочка собирается, выдан он на *.badssl.com — и под эту маску адрес wrong.host.badssl.com не подходит: звёздочка закрывает ровно один уровень имени, а тут их два. Команда из первого раздела такой сертификат приняла, браузер соединение отклонит.
Скрипт проверки цепочки, срока и имени
Собирать три проверки по кускам не придётся: в Python строгий набор уже готов. ssl.create_default_context() возвращает контекст, который сверяет цепочку до доверенного корня, срок действия и имя хоста. Задача сводится к тому, чтобы ничего из этого не выключить и аккуратно поймать исключение. Файл сохраняется как certwatch.py:
#!/usr/bin/env python3
"""certwatch.py - проверка TLS-сертификатов по списку хостов.
Запуск: python3 certwatch.py hosts.txt [дней_до_предупреждения]
Коды возврата: 0 - всё хорошо, 1 - есть предупреждения, 2 - есть отказы,
3 - сам скрипт запустить не удалось (нет файла, неверные аргументы).
"""
import socket
import ssl
import sys
from datetime import datetime, timezone
TIMEOUT = 10
RANK = {"OK": 0, "WARN": 1, "FAIL": 2}
def check(host, port, warn_days):
"""Строгое подключение: проверяются цепочка, имя хоста и срок сразу."""
context = ssl.create_default_context()
try:
with socket.create_connection((host, port), TIMEOUT) as sock:
with context.wrap_socket(sock, server_hostname=host) as tls:
cert = tls.getpeercert()
except ssl.SSLCertVerificationError as err:
return "FAIL", err.verify_message
except OSError as err:
return "FAIL", "нет соединения: {}".format(err)
seconds = ssl.cert_time_to_seconds(cert["notAfter"])
expires = datetime.fromtimestamp(seconds, timezone.utc)
left = (expires - datetime.now(timezone.utc)).days
issuer = dict(item[0] for item in cert["issuer"]).get("organizationName", "?")
note = "{} дн., до {} UTC, издатель {}".format(left, expires.strftime("%Y-%m-%d"), issuer)
return ("WARN" if left <= warn_days else "OK"), note
def main(argv):
if len(argv) < 2:
print(__doc__)
return 3
try:
warn_days = int(argv[2]) if len(argv) > 2 else 21
handle = open(argv[1], encoding="utf-8")
except (ValueError, OSError) as err:
print("не удалось начать проверку: {}".format(err), file=sys.stderr)
return 3
worst = 0
with handle:
for line in handle:
target = line.split("#")[0].strip()
if not target:
continue
host, _, port = target.partition(":")
try:
number = int(port or 443)
except ValueError:
state, note = "FAIL", "не разобрать порт в строке списка"
else:
state, note = check(host, number, warn_days)
print("{:<4} {:<32} {}".format(state, target, note))
worst = max(worst, RANK[state])
return worst
if __name__ == "__main__":
sys.exit(main(sys.argv))
err.verify_message — готовый текст причины из OpenSSL, тот же самый, что печатает s_client, так что расшифровывать числовые коды по таблице не нужно. Ошибка сети и ошибка TLS обе приходят как OSError, поэтому в выводе они помечены одинаково, словами «нет соединения», хотя соединение могло и состояться.
Дата разбирается не через datetime.strptime. В сертификате она записана по-английски, вида Oct 26 20:03:01 2026 GMT, а шаблон %b читает название месяца по текущей локали. Стоит программе где-нибудь вызвать setlocale — и разбор перестаёт работать (пример ниже требует, чтобы русская локаль в системе была собрана, иначе упадёт раньше, на самом setlocale):
python3 -c "
import locale, datetime
locale.setlocale(locale.LC_TIME, 'ru_RU.UTF-8')
datetime.datetime.strptime('Oct 26 20:03:01 2026 GMT', '%b %d %H:%M:%S %Y %Z')"
Последняя строка трейсбека:
ValueError: time data 'Oct 26 20:03:01 2026 GMT' does not match format '%b %d %H:%M:%S %Y %Z'
ssl.cert_time_to_seconds разбирает ту же строку без оглядки на локаль. Дальше время переводится в UTC, чтобы вывод не зависел от часового пояса сервера.
Порог, код возврата и запуск по расписанию
Список проверяемых адресов — обычный текстовый файл, здесь он называется hosts.txt: по хосту на строку, после двоеточия можно дописать порт, после решётки — комментарий.
badssl.com
expired.badssl.com
wrong.host.badssl.com
incomplete-chain.badssl.com
self-signed.badssl.com
python3 certwatch.py hosts.txt; echo "exit=$?"
OK badssl.com 62 дн., до 2026-10-26 UTC, издатель Let's Encrypt
FAIL expired.badssl.com certificate has expired
FAIL wrong.host.badssl.com Hostname mismatch, certificate is not valid for 'wrong.host.badssl.com'.
FAIL incomplete-chain.badssl.com unable to get local issuer certificate
FAIL self-signed.badssl.com self-signed certificate
exit=2
Число дней в первой строке меняется день ото дня, а четыре отказа под ней на этих хостах воспроизводятся постоянно: они для того и подняты. Второй аргумент задаёт порог предупреждения в днях. Вот тот же исправный хост, вынесенный в файл one.txt, с порогом больше оставшегося срока:
python3 certwatch.py one.txt 90; echo "exit=$?"
WARN badssl.com 62 дн., до 2026-10-26 UTC, издатель Let's Encrypt
exit=1
Коды возврата разведены нарочно: 2 — проверка нашла отказ, 1 — только предупреждения, 3 — скрипт вообще не смог начать работу. Для мониторинга это разные события, потому что в последнем случае чинить надо не сертификат, а запуск.
python3 certwatch.py nety-takogo-fayla.txt; echo "exit=$?"
не удалось начать проверку: [Errno 2] No such file or directory: 'nety-takogo-fayla.txt'
exit=3
Чтобы код возврата не пропадал впустую, запуск заворачивается в короткую обёртку: вывод копится в логе, а о ненулевом коде уходит запись в системный журнал, откуда её заберёт любая система сбора логов. Скрипт, список и обёртка кладутся в один каталог, скажем /opt/certwatch.
#!/bin/sh
# certwatch.sh - запуск по расписанию: лог в файл, о проблеме сообщаем в системный журнал
cd "$(dirname "$0")" || exit 3
/usr/bin/python3 certwatch.py hosts.txt 21 >> certwatch.log 2>&1
code=$?
[ "$code" -eq 0 ] || logger -t certwatch -p daemon.warning "проверка сертификатов вернула $code"
exit $code
0 8 * * * /opt/certwatch/certwatch.sh
Почта и нестандартные порты
Скрипт ходит в сеть оттуда, откуда запущен, а порт берёт из строки списка. Поэтому ему доступно и то, до чего снаружи не достучаться: внутренняя панель на 8443, почтовые порты, служебный сервис за фаерволом. Второй список, hosts-net.txt:
imap.yandex.ru:993
smtp.gmail.com:465
badssl.com:1000 # порт закрыт, так выглядит недоступный сервис
python3 certwatch.py hosts-net.txt 30; echo "exit=$?"
OK imap.yandex.ru:993 175 дн., до 2027-02-16 UTC, издатель GlobalSign nv-sa
OK smtp.gmail.com:465 69 дн., до 2026-11-02 UTC, издатель Google Trust Services
FAIL badssl.com:1000 нет соединения: [Errno 111] Connection refused
exit=2
Граница проходит по тому, когда включается шифрование. На 443, 993 и 465 оно начинается с первого байта, и скрипт работает. На 587 сессия открывается незашифрованной, а TLS поднимается командой STARTTLS уже внутри почтового диалога:
echo "smtp.gmail.com:587" > h587.txt
python3 certwatch.py h587.txt 21
FAIL smtp.gmail.com:587 нет соединения: [SSL: WRONG_VERSION_NUMBER] wrong version number (_ssl.c:1081)
Порт 587 в список класть не надо: сертификат там может быть в полном порядке, а строка навсегда останется отказом и утянет код возврата в двойку. Такие порты проверяются отдельной командой, где нужный почтовый диалог у openssl уже зашит:
openssl s_client -connect smtp.gmail.com:587 -starttls smtp \
-verify_hostname smtp.gmail.com </dev/null 2>/dev/null \
| grep "Verify return code"
Verify return code: 0 (ok)
Почему разовой проверки уже не хватает
Сертификат на год позволял обходиться напоминанием в календаре. Этот запас кончается: голосованием SC-081v3 от 11 апреля 2025 года CA/Browser Forum (объединение удостоверяющих центров и разработчиков браузеров, которое и задаёт правила выпуска сертификатов) утвердил график сокращения максимального срока — 398 дней до 15 марта 2026, 200 дней после, 100 дней с 15 марта 2027 и 47 дней с 15 марта 2029. Let’s Encrypt выдаёт сертификаты на 90 дней, а с 15 января 2026 года у него общедоступен профиль shortlived со сроком 160 часов, чуть больше шести суток.
При таких сроках выпуск и продление уходят в автоматику, и проверять придётся уже не календарь, а результат её работы: сертификат обновился, сервер перечитал файлы и отдаёт клиенту полную цепочку на нужное имя. Скрипт выше отвечает на этот вопрос, а список хостов правится текстовым файлом.
Короткие разборы и практика, которые до статьи не дорастают, лежат в канале @azbukait_ru.