community.crypto.openssl_certificate_info – Предоставление информации о сертификатах OpenSSL X.509

• Обзор
• Требования
• Параметры
• Примечания
• См. также
• Примеры
• Возвращаемые значения

Обзор

• Этот модуль позволяет запросить информацию о сертификатах OpenSSL.
• Он использует библиотеки pyOpenSSL или cryptography для взаимодействия с OpenSSL. Если доступны обе библиотеки (и соответствуют минимальным требованиям по версии), cryptography будет предпочтительным бэкендом по сравнению с PyOpenSSL (если бэкенд не принудительно задан с помощью select_crypto_backend). Обратите внимание, что бэкенд PyOpenSSL был устаревшим в Ansible 2.9 и будет удалён в community.crypto 2.0.0.
• Обратите внимание, что этот модуль назывался openssl_certificate_info при непосредственном включении в Ansible до версии 2.9. При перемещении в коллекцию community.crypto, он был переименован в community.crypto.x509_certificate_info. С Ansible 2.10 он по-прежнему может использоваться с прежним коротким именем (или с помощью ansible.builtin.openssl_certificate_info), которое перенаправляет на community.crypto.x509_certificate_info. При использовании полных имён классов или ключевого слова collections следует использовать новое имя community.crypto.x509_certificate_info, чтобы избежать предупреждения об устаревании.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

• PyOpenSSL >= 0.15 или cryptography >= 1.6

Параметры

Примечания

См. также

Примеры

- name: Generate a Self Signed OpenSSL certificate
  community.crypto.x509_certificate:
    path: /etc/ssl/crt/ansible.com.crt
    privatekey_path: /etc/ssl/private/ansible.com.pem
    csr_path: /etc/ssl/csr/ansible.com.csr
    provider: selfsigned


# Get information on the certificate

- name: Get information on generated certificate
  community.crypto.x509_certificate_info:
    path: /etc/ssl/crt/ansible.com.crt
  register: result

- name: Dump information
  debug:
    var: result


# Check whether the certificate is valid or not valid at certain times, fail
# if this is not the case. The first task (x509_certificate_info) collects
# the information, and the second task (assert) validates the result and
# makes the playbook fail in case something is not as expected.

- name: Test whether that certificate is valid tomorrow and/or in three weeks
  community.crypto.x509_certificate_info:
    path: /etc/ssl/crt/ansible.com.crt
    valid_at:
      point_1: "+1d"
      point_2: "+3w"
  register: result

- name: Validate that certificate is valid tomorrow, but not in three weeks
  assert:
    that:
      - result.valid_at.point_1      # valid in one day
      - not result.valid_at.point_2  # not valid in three weeks

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Авторы

• Felix Fontein (@felixfontein)
• Yanis Guenane (@Spredzy)
• Markus Teufelberger (@MarkusTeufelberger)