acme_challenge_cert_helper – Подготовка сертификатов, необходимых для вызовов ACME, таких как tls-alpn-01

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

Обзор

• Подготавливает сертификаты для вызовов ACME, таких как tls-alpn-01.
• Исходные данные предоставляются модулем acme_certificate, и их необходимо преобразовать в сертификат для использования при проверке вызова. Этот модуль предоставляет простой способ генерации необходимых сертификатов.

Требования

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

• cryptography >= 1.3

Параметры

См. также

Примеры

- name: Create challenges for a given CRT for sample.com
  acme_certificate:
    account_key_src: /etc/pki/cert/private/account.key
    challenge: tls-alpn-01
    csr: /etc/pki/cert/csr/sample.com.csr
    dest: /etc/httpd/ssl/sample.com.crt
  register: sample_com_challenge

- name: Create certificates for challenges
  acme_challenge_cert_helper:
    challenge: tls-alpn-01
    challenge_data: "{{ item.value['tls-alpn-01'] }}"
    private_key_src: /etc/pki/cert/key/sample.com.key
  loop: "{{ sample_com_challenge.challenge_data | dictsort }}"
  register: sample_com_challenge_certs

- name: Install challenge certificates
  # We need to set up HTTPS such that for the domain,
  # regular_certificate is delivered for regular connections,
  # except if ALPN selects the "acme-tls/1"; then, the
  # challenge_certificate must be delivered.
  # This can for example be achieved with very new versions
  # of NGINX; search for ssl_preread and
  # ssl_preread_alpn_protocols for information on how to
  # route by ALPN protocol.
  ...:
    domain: "{{ item.domain }}"
    challenge_certificate: "{{ item.challenge_certificate }}"
    regular_certificate: "{{ item.regular_certificate }}"
    private_key: /etc/pki/cert/key/sample.com.key
  loop: "{{ sample_com_challenge_certs.results }}"

- name: Create certificate for a given CSR for sample.com
  acme_certificate:
    account_key_src: /etc/pki/cert/private/account.key
    challenge: tls-alpn-01
    csr: /etc/pki/cert/csr/sample.com.csr
    dest: /etc/httpd/ssl/sample.com.crt
    data: "{{ sample_com_challenge }}"

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

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

Статус

• Для этого модуля не гарантируется обратная совместимость интерфейса. [предварительная версия]
• Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

• Felix Fontein (@felixfontein)