- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Community.Crypto Collection Docs

# community.crypto.openssl_signature_info module – Verify signatures with openssl

Note

This module is part of the community.crypto collection (version 2.14.1).

To install it, use: `ansible-galaxy collection install community.crypto`. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: `community.crypto.openssl_signature_info`.

New in community.crypto 1.1.0

## Synopsis

- This module allows one to verify a signature for a file by a certificate.

- The module uses the cryptography Python library.

## Requirements

The below requirements are needed on the host that executes this module.

- cryptography >= 1.4 (some key types require newer versions)

## Parameters

Parameter | Comments
--- | ---
certificate_content string | The content of the certificate used to verify the signature. Either `certificate_path` or `certificate_content` must be specified, but not both.
certificate_path path | The path to the certificate used to verify the signature. Either `certificate_path` or `certificate_content` must be specified, but not both.
path path / required | The signed file to verify. This file will only be read and not modified.
select_crypto_backend string | Determines which crypto backend to use. The default choice is `auto`, which tries to use `cryptography` if available. If set to `cryptography`, will try to use the cryptography library. Choices: `"auto"` ← (default) `"cryptography"`
signature string / required | Base64 encoded signature.

## Attributes

Attribute | Support | Description
--- | --- | ---
check_mode | Support: full This action does not modify state. | Can run in `check_mode` and return changed status prediction without modifying target.
diff_mode | Support: N/A This action does not modify state. | Will return details on what has changed (or possibly needs changing in `check_mode`), when in diff mode.

## Notes

Note

- When using the `cryptography` backend, the following key types require at least the following `cryptography` version: RSA keys: `cryptography` >= 1.4 DSA and ECDSA keys: `cryptography` >= 1.5 ed448 and ed25519 keys: `cryptography` >= 2.6

## See Also

See also

community.crypto.openssl_signature

  Sign data with openssl.

community.crypto.x509_certificate

  Generate and/or check OpenSSL certificates.

## Examples

    - 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

## Return Values

Common return values are documented here, the following are the fields unique to this module:

Key | Description
--- | ---
valid boolean | `true` means the signature was valid for the given file, `false` means it was not. Returned: success

### Authors

- Patrick Pichler (@aveexy)

- Markus Teufelberger (@MarkusTeufelberger)

### Collection links

Issue Tracker Repository (Sources) Submit a bug report Request a feature Communication