Linux

Проверить срок действия сертификатов

Проверяет TLS-сертификаты удалённых хостов и локальные PEM-файлы.

Python Linux Продвинутый
Скачать cert_check.py
Описание

Что делает скрипт

Скрипт подключается к указанным host:port, получает сертификат и считает дни до истечения. Локальные файлы разбираются через openssl. Порог предупреждения задаётся в днях, при истечении или ошибке код возврата будет 1. Сканирования чужих сетей нет, проверяются только явно указанные цели.

Запуск

Быстрый старт

python cert_check.py --host example.com:443

Скачайте файл, откройте терминал в папке со скриптом и выполните команду. В Linux и macOS интерпретатор может называться python3, в Windows - python или py.

Примеры

Другие варианты

  • python cert_check.py --host example.com:443 --warn-days 30
  • python cert_check.py --file /etc/ssl/certs/example.pem --file /etc/nginx/ssl/site.crt
  • python cert_check.py --host example.com --json certs.json
Зависимости

Что понадобится

Python 3.10+ Модули ssl и socket из стандартной библиотеки
Linux sudo apt install python3
openssl Разбор локальных PEM-файлов
Linux sudo apt install openssl
Исходник

cert_check.py

#!/usr/bin/env python3
"""Проверка срока действия TLS-сертификатов."""
from __future__ import annotations

import argparse
import json
import shutil
import socket
import ssl
import subprocess
import tempfile
from dataclasses import asdict, dataclass
from datetime import datetime, timezone
from pathlib import Path


@dataclass
class CertInfo:
    target: str
    kind: str
    subject: str
    issuer: str
    not_after: str
    days_left: int | None
    status: str
    error: str


def split_host(value: str) -> tuple[str, int]:
    if value.startswith("["):
        host, _, rest = value[1:].partition("]")
        port = rest[1:] if rest.startswith(":") else "443"
        return host, int(port)
    if value.count(":") == 1:
        host, port = value.rsplit(":", 1)
        if port.isdigit():
            return host, int(port)
    return value, 443


def format_name(parts) -> str:
    values = []
    for rdn in parts or ():
        for key, value in rdn:
            values.append(f"{key}={value}")
    return ", ".join(values)


def days_until(not_after: str) -> tuple[int | None, str]:
    try:
        epoch = ssl.cert_time_to_seconds(not_after)
    except (ValueError, TypeError):
        return None, not_after
    expiry = datetime.fromtimestamp(epoch, tz=timezone.utc)
    now = datetime.now(timezone.utc)
    return (expiry - now).days, expiry.strftime("%Y-%m-%d %H:%M:%S UTC")


def parse_pem(path: Path) -> dict[str, str]:
    result = subprocess.run(
        ["openssl", "x509", "-in", str(path), "-noout", "-subject", "-issuer", "-enddate"],
        capture_output=True,
        text=True,
        check=False,
    )
    if result.returncode != 0:
        return {"error": result.stderr.strip() or "openssl не смог прочитать сертификат"}
    data = {}
    for line in result.stdout.splitlines():
        key, _, value = line.partition("=")
        data[key.strip()] = value.strip()
    return data


def check_remote(host: str, port: int, timeout: float, insecure: bool) -> CertInfo:
    target = f"{host}:{port}"
    context = ssl._create_unverified_context() if insecure else ssl.create_default_context()
    try:
        with socket.create_connection((host, port), timeout=timeout) as raw:
            with context.wrap_socket(raw, server_hostname=host) as tls:
                certificate = tls.getpeercert()
                der = tls.getpeercert(binary_form=True)
    except (OSError, ssl.SSLError) as error:
        return CertInfo(target, "remote", "-", "-", "-", None, "error", str(error)[:200])

    if certificate:
        not_after = certificate.get("notAfter", "")
        days, formatted = days_until(not_after)
        return CertInfo(target, "remote", format_name(certificate.get("subject")), format_name(certificate.get("issuer")), formatted, days, "ok", "")

    if not der:
        return CertInfo(target, "remote", "-", "-", "-", None, "error", "сертификат не получен")
    with tempfile.NamedTemporaryFile("w", suffix=".pem", delete=False) as handle:
        handle.write(ssl.DER_cert_to_PEM_cert(der))
        temporary = Path(handle.name)
    try:
        parsed = parse_pem(temporary)
    finally:
        temporary.unlink(missing_ok=True)
    if "error" in parsed:
        return CertInfo(target, "remote", "-", "-", "-", None, "error", parsed["error"])
    not_after = parsed.get("notAfter", "")
    days, formatted = days_until(not_after)
    return CertInfo(target, "remote", parsed.get("subject", "-"), parsed.get("issuer", "-"), formatted, days, "ok", "")


def check_file(path: Path) -> CertInfo:
    target = str(path)
    if not path.is_file():
        return CertInfo(target, "file", "-", "-", "-", None, "error", "файл не найден")
    parsed = parse_pem(path)
    if "error" in parsed:
        return CertInfo(target, "file", "-", "-", "-", None, "error", parsed["error"])
    not_after = parsed.get("notAfter", "")
    days, formatted = days_until(not_after)
    return CertInfo(target, "file", parsed.get("subject", "-"), parsed.get("issuer", "-"), formatted, days, "ok", "")


def main() -> int:
    parser = argparse.ArgumentParser(description="Проверка TLS-сертификатов")
    parser.add_argument("--host", action="append", default=[], help="host:port, можно несколько раз")
    parser.add_argument("--file", type=Path, action="append", default=[], help="Локальный PEM-файл")
    parser.add_argument("--warn-days", type=int, default=30, help="Порог предупреждения в днях")
    parser.add_argument("--timeout", type=float, default=10.0, help="Таймаут соединения")
    parser.add_argument("--insecure", action="store_true", help="Не проверять цепочку удалённого сертификата")
    parser.add_argument("--json", type=Path, help="Сохранить отчёт в JSON")
    args = parser.parse_args()

    if not args.host and not args.file:
        parser.error("Укажите --host или --file")
    if shutil.which("openssl") is None:
        print("openssl не найден. Установите openssl.")
        return 2

    reports: list[CertInfo] = []
    for value in args.host:
        host, port = split_host(value)
        reports.append(check_remote(host, port, args.timeout, args.insecure))
    for path in args.file:
        reports.append(check_file(path))

    problems = 0
    print(f"{'ЦЕЛЬ':<42} {'ДО':<20} {'ДНЕЙ':>6} {'СТАТУС':<10} SUBJECT")
    print("-" * 120)
    for report in reports:
        days = "-" if report.days_left is None else str(report.days_left)
        print(f"{report.target:<42} {report.not_after:<20} {days:>6} {report.status:<10} {report.subject}")
        if report.error:
            print(f"  ошибка: {report.error}")
            problems += 1
            continue
        if report.days_left is None:
            print("  не удалось разобрать дату")
            problems += 1
        elif report.days_left < 0:
            print("  [WARN] сертификат истёк")
            problems += 1
        elif report.days_left <= args.warn_days:
            print(f"  [WARN] осталось {report.days_left} дней при пороге {args.warn_days}")
            problems += 1

    if args.json:
        args.json.write_text(json.dumps([asdict(item) for item in reports], ensure_ascii=False, indent=2) + "\n", encoding="utf-8")
        print(f"\nJSON сохранён: {args.json}")

    if problems:
        print(f"\nПроблемных сертификатов: {problems}")
        return 1
    print("\nВсе сертификаты в порядке.")
    return 0


if __name__ == "__main__":
    raise SystemExit(main())

Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.

CLI 1.0.0

Скачать без браузера

Команда скачает этот файл в текущую папку. CLI работает на Windows, macOS и Linux.

scriptdock get linux-cert-check
  • Поиск по всему каталогу
  • Python 3.10+
  • Без внешних пакетов
Скачать CLI

GUI-версия готовится. Подробнее

Категория

Linux

Bash и Python для серверов, рабочих станций и повседневных задач Linux.