Skip to main content

A Python utility for checking states of ssl certificates

Project description

sslexp

check a state of your ssl certificates simply and cleverly

Build Status Language grade: Python made-with-python Python 3.6 Open Source Love

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

sslexp-1.4.0-py3-none-any.whl (5.1 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page