community.crypto.x509_certificate_pipe – Генерация и/или проверка сертификатов OpenSSL

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

Обзор

• Если доступны библиотеки cryptography и PyOpenSSL (и удовлетворяют минимальным требованиям к версии), cryptography будет предпочтительнее в качестве бэкэнда по сравнению с PyOpenSSL (если бэкэнд не принудительно установлен с помощью select_crypto_backend). Обратите внимание, что бэкэнд PyOpenSSL был устаревшим в Ansible 2.9 и будет удален в community.crypto 2.0.0.
• Он реализует понятие поставщика (например, selfsigned, ownca, entrust) для вашего сертификата.
• Он использует библиотеки pyOpenSSL или cryptography для взаимодействия с OpenSSL.
• Обратите внимание, что модуль перегенерирует существующий сертификат, если он не соответствует параметрам модуля или, если он кажется повреждённым. Если вы опасаетесь, что это может перезаписать ваш существующий сертификат, рассмотрите использование опции backup.
• Поставщик ownca предназначен для генерации сертификата OpenSSL, подписанного вашим собственным сертификатом CA (Certificate Authority) (самоподписанный сертификат).
• Этот модуль позволяет (пере)генерировать сертификаты OpenSSL.

Требования

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

• PyOpenSSL >= 0.15 или cryptography >= 1.6 (при использовании selfsigned, ownca или assertonly поставщика)

Параметры

Примечания

См. также

Примеры

- name: Generate a Self Signed OpenSSL certificate
  community.crypto.x509_certificate_pipe:
    provider: selfsigned
    privatekey_path: /etc/ssl/private/ansible.com.pem
    csr_path: /etc/ssl/csr/ansible.com.csr
  register: result
- ansible.builtin.debug:
    var: result.certificate

# In the following example, both CSR and certificate file are stored on the
# machine where ansible-playbook is executed, while the OwnCA data (certificate,
# private key) are stored on the remote machine.

- name: (1/2) Generate an OpenSSL Certificate with the CSR provided inline
  community.crypto.x509_certificate_pipe:
    provider: ownca
    content: "{{ lookup('file', '/etc/ssl/csr/www.ansible.com.crt') }}"
    csr_content: "{{ lookup('file', '/etc/ssl/csr/www.ansible.com.csr') }}"
    ownca_cert: /path/to/ca_cert.crt
    ownca_privatekey: /path/to/ca_cert.key
    ownca_privatekey_passphrase: hunter2
  register: result

- name: (2/2) Store certificate
  ansible.builtin.copy:
    dest: /etc/ssl/csr/www.ansible.com.crt
    content: "{{ result.certificate }}"
  delegate_to: localhost
  when: result is changed

# In the following example, the certificate from another machine is signed by
# our OwnCA whose private key and certificate are only available on this
# machine (where ansible-playbook is executed), without having to write
# the certificate file to disk on localhost. The CSR could have been
# provided by community.crypto.openssl_csr_pipe earlier, or also have been
# read from the remote machine.

- name: (1/3) Read certificate's contents from remote machine
  ansible.builtin.slurp:
    src: /etc/ssl/csr/www.ansible.com.crt
  register: certificate_content

- name: (2/3) Generate an OpenSSL Certificate with the CSR provided inline
  community.crypto.x509_certificate_pipe:
    provider: ownca
    content: "{{ certificate_content.content | b64decode }}"
    csr_content: "{{ the_csr }}"
    ownca_cert: /path/to/ca_cert.crt
    ownca_privatekey: /path/to/ca_cert.key
    ownca_privatekey_passphrase: hunter2
  delegate_to: localhost
  register: result

- name: (3/3) Store certificate
  ansible.builtin.copy:
    dest: /etc/ssl/csr/www.ansible.com.crt
    content: "{{ result.certificate }}"
  when: result is changed

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

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

Авторы

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