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

Примечание

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

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

Для использования в playbook укажите: 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

См. также

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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/crypto/openssl_signature_info_module.html