You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
ansible/changelogs/fragments/76681-ansible-galaxy-add-gp...

25 lines
1.5 KiB
YAML

ansible-galaxy - add signature verification of the MANIFEST.json (#76681) * ansible-galaxy collection install|verify: - Support verifying the origin of the MANIFEST.json when the Galaxy server has provided signatures. - Allow supplemental signatures to use during verification on the CLI/requirements file. * ansible-galaxy collection install: - Support disabling signature verification. This silences the warning provided by ansible-galaxy if the Galaxy server provided signatures it cannot use because no keyring is configured. - Store Galaxy server metadata alongside installed collections for provenance. This is used by 'ansible-galaxy collection verify --offline'. * Add unit tests for method that gets signatures from a Galaxy server * Add integration tests for user-provided signature sources - Test CLI option combinations - Test installing collections with valid/invalid signature sources - Test disabling GPG verification when installing collections - Test verifying collections with valid/invalid signature sources * Make signature verification advisory-by-default if signatures are provided by the Galaxy server - Make the default keyring None - Warn if the keyring is None but the Galaxy server provided signatures - Error if the keyring is None but the user supplied signatures - Error if the keyring is not None but is invalid * changelog * add ansible-galaxy user documentation for new options Co-authored-by: Matt Martz <matt@sivel.net> Co-authored-by: Sviatoslav Sydorenko <wk.cvs.github@sydorenko.org.ua> Co-authored-by: Martin Krizek <martin.krizek@gmail.com> Co-authored-by: Sandra McCann <samccann@redhat.com> Co-authored-by: Andy Mott <amott@redhat.com> Co-authored-by: John R Barker <john@johnrbarker.com>
3 years ago
minor_changes:
- >-
``ansible-galaxy collection [install|verify]`` - use gpg to verify the authenticity of
the signed ``MANIFEST.json`` with ASCII armored detached signatures provided by the Galaxy
server. The keyring (which is not managed by ``ansible-galaxy``) must be provided with
the ``--keyring`` option to use signature verification.
If no ``--keyring`` is specified and the collection to ``install|verify`` has associated
detached signatures on the Galaxy server, a warning is provided.
- >-
``ansible-galaxy collection [install|verify]`` - allow user-provided signature sources
in addition to those from the Galaxy server.
Each collection entry in a requirements file can specify a ``signatures`` key followed by
a list of sources.
Collection name(s) provided on the CLI can specify additional signature sources by using
the ``--signatures`` CLI option.
Signature sources should be URIs that can be opened with ``urllib.request.urlopen()``, such as
"https://example.com/path/to/detached_signature.asc" or "file:///path/to/detached_signature.asc".
The ``--keyring`` option must be specified if signature sources are provided.
- >-
``ansible-galaxy collection install`` - Store Galaxy server metadata alongside installed
collections for provenance. Signatures obtained from the Galaxy server can be used for offline
verification with ``ansible-galaxy collection verify --offline``.
- >-
``ansible-galaxy collection install`` - Add a global toggle to turn off GPG signature verification.