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

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

Обзор

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

Требования

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

• 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)