A Python utility for checking states of ssl certificates
Project description
sslexp
check a state of your ssl certificates simply and cleverly
This program checks the expiration date of an ssl certificate. First set the url param that should contain the url address of a domain. The program returns a message and a status code based on a measurement result.
Installation
# using pip
pip install sslexp
# or if you are running multiple versions of python such as 2.7.x and 3.x
pip3 install sslexp
# from source using git clone
git clone https://github.com/patrikskrivanek/ssl_expiration.git
# from source using wget
wget https://github.com/patrikskrivanek/ssl_expiration/blob/master/sslexp
Documentation
Argument | Description | Data type | Required |
---|---|---|---|
--url | URL of an ssl certificate for check | string | yes |
--warning | Number of days for warning output | integer | no [default: 30] |
--critical | Number of days for critical output | integer | no [default: 20] |
--port | SSL port | integer | no [default: 443] |
--timeout | Timeout in seconds for check | integer | no [default: 3] |
--output | Output format (text, json, nagios) | string | no [default: text] |
--version | Show program version | optional | |
-h --help | Show program help and usage | optional |
Status | Exit code |
---|---|
STATE_OK | 0 |
STATE_WARNING | 1 |
STATE_CRITICAL | 2 |
STATE_UNKNOWN | 3 |
Examples
# check an ssl cert of github
sslexp --url github.com
# check the cert with your own warning and critical params
sslexp --url github.com --warning 5 --critical 3
# check the ssl certificate on specific port
sslexp --url website.com --port 8085
# check the ssl cert with timeout
sslexp --url website.com --timeout 5
# check the ssl cert with specific output
sslexp --url website.com --output json
# show program help
sslexp --help
# show program version
sslexp --version
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
No source distribution files available for this release.See tutorial on generating distribution archives.
Built Distribution
File details
Details for the file sslexp-1.4.0-py3-none-any.whl
.
File metadata
- Download URL: sslexp-1.4.0-py3-none-any.whl
- Upload date:
- Size: 5.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/41.1.0 requests-toolbelt/0.9.1 tqdm/4.33.0 CPython/3.6.9
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 9c0c629a62bfecc5b4ba78902ea06939bbcafe2e88d7e0d051711ecdb4e42e44 |
|
MD5 | 8cd2838a57553378f162062da8a20b63 |
|
BLAKE2b-256 | 6023a8c0cd192e0ea16fe89fde612c3303bf2aaa811fd2936e63388a446a7088 |