community.crypto.get_certificate – Get a certificate from a host:port

• Synopsis
• Requirements
• Parameters
• Notes
• Examples
• Return Values

Synopsis

• Makes a secure connection and returns information about the presented certificate
• The module can use the cryptography Python library, or the pyOpenSSL Python library. By default, it tries to detect which one is available. This can be overridden with the select_crypto_backend option. Please note that the PyOpenSSL backend was deprecated in Ansible 2.9 and will be removed in community.crypto 2.0.0.
• Support SNI only with python >= 2.7

Requirements

The below requirements are needed on the host that executes this module.

• python >= 2.7 when using proxy_host
• cryptography >= 1.6 or pyOpenSSL >= 0.15

Parameters

Notes

Examples

- name: Get the cert from an RDP port
  community.crypto.get_certificate:
    host: "1.2.3.4"
    port: 3389
  delegate_to: localhost
  run_once: true
  register: cert

- name: Get a cert from an https port
  community.crypto.get_certificate:
    host: "www.google.com"
    port: 443
  delegate_to: localhost
  run_once: true
  register: cert

- name: How many days until cert expires
  debug:
    msg: "cert expires in: {{ expire_days }} days."
  vars:
    expire_days: "{{ (( cert.not_after | to_datetime('%Y%m%d%H%M%SZ')) - (ansible_date_time.iso8601 | to_datetime('%Y-%m-%dT%H:%M:%SZ')) ).days }}"

Return Values

Common return values are documented here, the following are the fields unique to this module:

Authors

• John Westcott IV (@john-westcott-iv)