Skip to main content

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

Project description


Travis Build Status Build Status Master Build Status Develop


Codacy Grade Code Climate Maintainability Sonar Quality Gate Status Sonar Reliability Rating


Coveralls Test Coverage CodeCov Code Climate Test Coverage


Updates Python 3 Requirements Status


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.

Source Distribution

ssl_certinfo-1.1.2.tar.gz (10.5 kB view hashes)

Uploaded source

Built Distribution

ssl_certinfo-1.1.2-py3-none-any.whl (9.4 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page