sslexp

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