SSL Tests

Quickstart#

Validates an SSL certificate and in case of successful validation extracts values. The probe exposes three modes.

todo

Usecases#

todo

  • check your SSL certificate is still up to date,
  • xxxx

Parameters#

Mode Description
valid default Returns the certificate validity. In case of valid certificate the latter is returned in the full response object.
expiry Returns the expiry date of a valid certificate.
aliases Returns all the aliases associated with a valid certificate.

The following parameters can be used to configure the test:

Parameter Description
host IP address or string IP address or hostname of the remote host.
port integer TCP port where the SSL/TLS session can be established.
date-format string Specify the format of the date to return in expiry mode. All the possible formats are listed in the table below. If this parameter is omitted, the expiration timestamp is returned as presented in the certificate.

Date formats

date-format parameter value Example of returned timestamp Description
unixtime 1504601611 UNIX timestamp
c, C or iso8601 2017-09-05T11:53:31.896389 ISO8601 format
days_left 351 Days left until the certificate expires.