К содержимому

← Блог

25.08.2026 · обновлено 01.10.2026 · сделай сам · 49 просмотров

Проверяем 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.