Skip to content
TPOALOSPublic

About

TLS certificate expiry checker for your own hosts, cron-friendly (stdlib-only Python)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

4 Commits

Folders and files

Repository files navigation

certwatch

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.

Usage

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.com

hosts.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

Tests run fully offline (the network fetch is injected):

python3 -m unittest -v

License

MIT (c) TPOALOS


More tools by TPOALOS: cronnext · dupefind · backupcheck · all 51 tools

About

TLS certificate expiry checker for your own hosts, cron-friendly (stdlib-only Python)

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages