Check TLS certificate expiry for hosts you operate. Opens a normal, verified TLS
connection and reads the certificate's notAfter date. Standard library only.
Use it only against servers you own or are authorized to monitor.
python3 certwatch.py example.com
python3 certwatch.py example.com:8443 internal.example.org
python3 certwatch.py -f hosts.txt --warn 45 --crit 10
python3 certwatch.py -f hosts.txt --json --workers 16 --timeout 5
# or: pip install git+https://github.com/TPOALOS/certwatch && certwatch example.comhosts.txt holds one host or host:port per line; # starts a comment.
Statuses: OK, WARNING (under --warn days, default 30), CRITICAL (under
--crit, default 7), EXPIRED, INVALID (verification failed, e.g. untrusted or
hostname mismatch), ERROR (network problem).
--json adds the subject, issuer, DNS subject alternative names, not_after and days_left for every host. Hosts are checked in
parallel (--workers, default 8) and always reported in the order you gave them. --crit must be lower than --warn.
Exit codes: 0 all OK, 1 any non-OK result, 2 usage error. Suitable for cron.
Tests run fully offline (the network fetch is injected):
python3 -m unittest -vMIT (c) TPOALOS
More tools by TPOALOS: cronnext · dupefind · backupcheck · all 51 tools