Проверить срок действия сертификатов
Проверяет TLS-сертификаты удалённых хостов и локальные PEM-файлы.
Что делает скрипт
Скрипт подключается к указанным 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 30python cert_check.py --file /etc/ssl/certs/example.pem --file /etc/nginx/ssl/site.crtpython cert_check.py --host example.com --json certs.json
Что понадобится
sudo apt install python3
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())
Скрипты работают с файлами и настройками системы. Перед запуском прочитайте код и проверьте пути. Особенно если скрипт удаляет, перезаписывает или перемещает данные.