community.crypto.openssl_signature_info – Проверка подписей с помощью openssl

Примечание

Этот плагин входит в коллекцию community.crypto (версия 1.4.0).

Для его установки используйте: ansible-galaxy collection install community.crypto.

Для использования в книге задач укажите: community.crypto.openssl_signature_info.

В версии 1.1.0: из community.crypto

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

Описание

Этот модуль позволяет проверить подпись файла с помощью сертификата.
Модуль может использовать библиотеку cryptography или pyOpenSSL. По умолчанию он пытается определить, какая из них доступна. Это можно переопределить с помощью опции select_crypto_backend. Обратите внимание, что бэкэнд PyOpenSSL был устаревшим в Ansible 2.9 и будет удален в community.crypto 2.0.0.

Требования

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

Либо cryptography >= 1.4 (некоторые типы ключей требуют более новых версий)
Либо pyOpenSSL >= 0.11 (ключи Ed25519 и Ed448 не поддерживаются с этим бэкэндом)

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
certificate_content строка		Содержимое сертификата, используемого для проверки подписи. Должен быть указан либо certificate_path, либо certificate_content, но не оба.
certificate_path путь		Путь к сертификату, используемому для проверки подписи. Должен быть указан либо certificate_path, либо certificate_content, но не оба.
path путь / обязательный		Подписываемый файл для проверки. Этот файл будет только прочитан и не будет изменён.
select_crypto_backend строка	Варианты: auto ← cryptography pyopenssl	Определяет, какой бэкэнд шифрования использовать. По умолчанию выбирается `auto`, который пытается использовать `cryptography` при его наличии и переходит на `pyopenssl` в противном случае. Если установлено `pyopenssl`, будет пытаться использовать библиотеку pyOpenSSL. Если установлено `cryptography`, будет пытаться использовать библиотеку cryptography.
signature строка / обязательный		Подпись в кодировке Base64.

Примечания

Примечание

При использовании бэкэнда cryptography, следующие типы ключей требуют как минимум следующие версии cryptography: ключи RSA: cryptography >= 1.4 ключи DSA и ECDSA: cryptography >= 1.5 ключи ed448 и ed25519: cryptography >= 2.6
Поддерживает check_mode.

См. также

community.crypto.openssl_signature: Официальная документация по модулю community.crypto.openssl_signature.
community.crypto.x509_certificate: Официальная документация по модулю community.crypto.x509_certificate.

Примеры

- name: Sign example file
  community.crypto.openssl_signature:
    privatekey_path: private.key
    path: /tmp/example_file
  register: sig

- name: Verify signature of example file
  community.crypto.openssl_signature_info:
    certificate_path: cert.pem
    path: /tmp/example_file
    signature: "{{ sig.signature }}"
  register: verify

- name: Make sure the signature is valid
  assert:
    that:
      - verify.valid

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

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

Ключ	Возвращаемое значение	Описание
valid булево	успех	`true` означает, что подпись была валидной для данного файла, `false` означает, что она не была.

Авторы

Patrick Pichler (@aveexy)
Markus Teufelberger (@MarkusTeufelberger)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/crypto/openssl_signature_info_module.html