Мониторинг и отчёты

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

Показывает дату окончания сертификата и число дней до истечения с предупреждениями.

Python Windows macOS Linux Новичок
Скачать ssl_expiry.py
Описание

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

Скрипт подключается к узлу по TLS, читает сертификат без проверки доверия и вычисляет остаток срока. Предупреждение и критический статус задаются в днях. Подходит для проверки example.com и локальных тестовых сервисов.

Запуск

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

python ssl_expiry.py --host example.com --port 443

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

Примеры

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

  • python ssl_expiry.py --host example.com --warn-days 45 --crit-days 10
  • python ssl_expiry.py --host 127.0.0.1 --port 8443 --json
Зависимости

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

Python 3.10+ Только стандартная библиотека
Windows winget install Python.Python.3.12
macOS brew install python
Linux sudo apt install python3
Исходник

ssl_expiry.py

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

import argparse
import json
import os
import socket
import ssl
import sys
import tempfile
from datetime import datetime, timezone


def decode_certificate(der: bytes) -> dict:
    pem = ssl.DER_cert_to_PEM_cert(der)
    descriptor, path = tempfile.mkstemp(suffix=".pem")
    try:
        with os.fdopen(descriptor, "w", encoding="ascii") as handle:
            handle.write(pem)
        return ssl._ssl._test_decode_cert(path)
    finally:
        os.unlink(path)


def read_certificate(host: str, port: int, timeout: float) -> dict:
    context = ssl.create_default_context()
    context.check_hostname = False
    context.verify_mode = ssl.CERT_NONE
    with socket.create_connection((host, port), timeout=timeout) as raw:
        with context.wrap_socket(raw, server_hostname=host) as tls:
            cert = tls.getpeercert()
            if not cert:
                der = tls.getpeercert(binary_form=True)
                if not der:
                    raise RuntimeError("сервер не вернул сертификат")
                cert = decode_certificate(der)
    return cert


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


def main() -> int:
    parser = argparse.ArgumentParser(description="Срок действия SSL-сертификата")
    parser.add_argument("--host", default="example.com")
    parser.add_argument("--port", type=int, default=443)
    parser.add_argument("--warn-days", type=int, default=30)
    parser.add_argument("--crit-days", type=int, default=7)
    parser.add_argument("--timeout", type=float, default=10.0)
    parser.add_argument("--json", action="store_true")
    args = parser.parse_args()

    try:
        cert = read_certificate(args.host, args.port, args.timeout)
        not_after = cert.get("notAfter")
        if not not_after:
            raise RuntimeError("в сертификате нет поля notAfter")
        expires = datetime.fromtimestamp(ssl.cert_time_to_seconds(not_after), tz=timezone.utc)
    except (OSError, ssl.SSLError, RuntimeError, ValueError) as error:
        print(f"ОШИБКА: {error}", file=sys.stderr)
        return 2

    now = datetime.now(timezone.utc)
    days = (expires - now).total_seconds() / 86400.0
    if days <= args.crit_days:
        status = 2
    elif days <= args.warn_days:
        status = 1
    else:
        status = 0

    payload = {
        "host": args.host,
        "port": args.port,
        "subject": format_name(cert.get("subject")),
        "issuer": format_name(cert.get("issuer")),
        "expires": expires.isoformat(),
        "days_left": round(days, 1),
        "status": status,
    }
    if args.json:
        print(json.dumps(payload, ensure_ascii=False, indent=2))
    else:
        print(f"Узел: {args.host}:{args.port}")
        print(f"Кому выдан: {payload['subject']}")
        print(f"Кем выдан: {payload['issuer']}")
        print(f"Действует до: {expires.strftime('%Y-%m-%d %H:%M:%S %Z')}")
        print(f"Осталось дней: {days:.1f}")
        print("OK" if status == 0 else "WARNING" if status == 1 else "CRITICAL")
    return status


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

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

CLI 1.0.0

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

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

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

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

Категория

Мониторинг и отчёты

Сбор метрик, проверка доступности, отчёты и уведомления.