Skip to main content

SSL CertInfo displays expiration dates and other information for SSL certificates from a set of hosts.

Project description

build Travis Build Status
quality Codacy Grade Code Climate Maintainability Sonar Quality Gate Status Sonar Reliability Rating
coverage Coveralls Test Coverage CodeCov Code Climate Test Coverage
dependencies Updates Python 3 Requirements Status
package Version Python versions supported PyPI downloads

SSL CertInfo displays expiration dates and other information for SSL certificates from a set of hosts.


  • Hosts to be scanned can be specified as a list of
    • hostnames (fully qualified domain names), e.g.,
    • ip addresses, e.g.,
    • ip networks in CIDR format, e.g.,
    • ip ranges, e.g.,
    • or any combination of the previous.
  • Connect to target hosts via an http proxy (optional).
  • Results will be presented in various output formats: --table, --json, --yaml, --csv, --raw.


You can download and install the latest version of this software from the Python package index (PyPI) as follows:

$ pip install ssl_certinfo


When you install ssl_certinfo, a command-line script called ssl_certinfo is placed on your path. You can invoke ssl_certinfo directly via this script from the command line:

$ ssl_certinfo [...]

You can also invoke it through the Python interpreter from the command line:

$ python -m ssl_certinfo [...]

Help is available with the --help or -h switch:

$ ssl_certinfo -h
usage: ssl_certinfo [-h] [-V] [-v | -q] [-p PORT] [-t TIMEOUT] [-x [protocol://]host[:port]] [-T | -j | -y | -c | -r] [host [host ...]]

Collect information about SSL certificates from a set of hosts

positional arguments:
host                  Connect to HOST

optional arguments:
-h, --help            show this help message and exit
-V, --version         display version information and exit
-v, --verbose         verbose output (repeat for increased verbosity)
-q, --quiet           quiet output (show errors only)
-p PORT, --port PORT  TCP port to connnect to [0-65535]
-t TIMEOUT, --timeout TIMEOUT
                      Maximum time allowed for connection
-x [protocol://]host[:port], --proxy [protocol://]host[:port]
                      Use the specified proxy
-T, --table           Print results in table format
-j, --json            Print results in JSON format
-y, --yaml            Print results in YAML format
-c, --csv             Print results in CSV format
-r, --raw             Print results in raw format


Optionally an http proxy can be specified which will be used to connect to the target hosts. The proxy can be specified using the -x, --proxy option or using one of the following environment variables:

  • http_proxy
  • https_proxy

The environment variables can be specified in lower case or upper case. The lower case version has precedence.

The -x, --proxy option overrides existing environment variables that set the proxy to use. If there’s an environment variable setting a proxy, you can use -x "" to override it.


This package was created with Cookiecutter and the stdtom/cookiecutter-pypackage-pipenv project template, based on audreyr/cookiecutter-pypackage.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ssl-certinfo, version 1.1.1
Filename, size File type Python version Upload date Hashes
Filename, size ssl_certinfo-1.1.1-py3-none-any.whl (9.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size ssl_certinfo-1.1.1.tar.gz (10.2 kB) File type Source Python version None Upload date Hashes View

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 Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page