Модуль community.crypto.openssl_signature_info — проверка подписей с помощью OpenSSL

Примечание

Этот модуль входит в коллекцию community.crypto (версия 3.2.1).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.crypto. Для использования этого модуля могут потребоваться дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в playbook, укажите: community.crypto.openssl_signature_info.

Добавлено в community.crypto 1.1.0

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

Краткое описание

Этот модуль позволяет проверить подпись файла с помощью сертификата.
Модуль использует библиотеку Python cryptography.

Требования

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

cryptography >= 3.3

Параметры

Параметр	Комментарии
certificate_content string	Содержимое сертификата, используемого для проверки подписи. Необходимо указать либо `certificate_path`, либо `certificate_content`, но не оба параметра одновременно.
certificate_path path	Путь к сертификату, используемому для проверки подписи. Необходимо указать либо `certificate_path`, либо `certificate_content`, но не оба параметра одновременно.
path path / обязательный	Подписанный файл, который нужно проверить. Файл будет только прочитан, но не изменён.
select_crypto_backend string	Определяет, какую криптографическую серверную часть использовать. По умолчанию выбирается `auto`; при наличии она пытается использовать `cryptography`. Если установлено значение `cryptography`, модуль попытается использовать библиотеку cryptography. Обратите внимание, что в community.crypto 3.0.0 все значения работают одинаково. В более поздней версии этот параметр будет объявлен устаревшим. Рекомендуется не задавать его явно. Варианты: `"auto"` ← (по умолчанию) `"cryptography"`
signature string / обязательный	Подпись в кодировке Base64.

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная Это действие не изменяет состояние.	Может выполняться в `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: Н/Д Это действие не изменяет состояние.	В режиме diff будут возвращены сведения об изменениях (или о возможных изменениях в `check_mode`).
idempotent	Поддержка: полная Это действие не изменяет состояние.	При повторном запуске с теми же аргументами вне режима проверки модуль сообщает об отсутствии изменений. Предполагается, что состояние системы, которой управляет модуль или которую он проверяет, существенно не изменилось.

См. также

community.crypto.openssl_signature: Подписывает данные с помощью OpenSSL.
community.crypto.x509_certificate: Создаёт сертификаты OpenSSL и/или проверяет их.

Примеры

---
- 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
  ansible.builtin.assert:
    that:
      - verify.valid

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

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

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

Авторы

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

Ссылки на коллекцию

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