SKOPEO-STANDALONE-VERIFY(1)

πŸ’– skopeo-standalone-verify β€” the skopeo-standalone-verify(1) glow-up πŸ’–

okay bestie, pull up a chair, because this one is a debugging tool and I need you to hear that with your whole chest 🫢


✨ NAME ✨

skopeo-standalone-verify β€” a debugging tool that verifies an image signature from local files. that's it, that's the gig πŸ’…


🌸 SYNOPSIS 🌸

skopeo standalone-verify manifest docker-reference key-fingerprints signature

πŸ¦‹ DESCRIPTION πŸ¦‹

so what are we doing here? we're verifying a signature using local files, and if it works, the digest gets printed. success looks like a little victory lap, no cap πŸŽ€

lowkey important though: this is primarily a debugging tool. it's useful for special cases, and it usually should not be a part of your normal operational workflow. fr fr. also, please consider configuring a signature verification policy file, as per containers-policy.json(5). that's the grown-up move ✨

now the args, one by one, no skipping πŸ‘‘

  • manifest β€” path to a file containing the image manifest πŸ“„
  • docker-reference β€” a docker reference that's expected to identify the image in the signature 🐳
  • key-fingerprints β€” identities of trusted signing keys (comma separated), or any to trust any known key when using a public key file πŸ”‘
  • signature β€” path to the signature file ✍️
🚨 Note: if you do use this, make sure that the image can not be changed at the source location between the times of its verification and use. like, between verify o'clock and use o'clock. no sneaky swaps. πŸ’€

πŸ’… OPTIONS πŸ’…

also peep skopeo(1) for options placed before the subcommand name, bestie πŸ‘€

  • --help, -h β€” print usage statement. the classic. the icon. the "what does this even do" button 🌈
  • --public-key-file public key file β€” file containing the public keys to use when verifying signatures. if this is not specified, keys from the GPG homedir are used. so either you hand me the keys, or I go dig through the GPG homedir myself πŸ—οΈ

⭐ EXAMPLES ⭐

look at her go πŸ₯Ή

$ skopeo standalone-verify busybox-manifest.json registry.example.com/example/busybox 1D8230F6CDB6A06716E414C1DB72F2188BB46CC8  busybox.signature
Signature verified, digest sha256:20bf21ed457b390829cdbeec8795a7bea1626991fda603e0d01b4e7f60427e55

she ATE. digest printed, verification verified, main character energy confirmed πŸ‘‘


🧚 NOTES 🧚


πŸ”₯ SEE ALSO πŸ”₯

skopeo(1), containers-signature(5), containers-policy.json(5)


πŸ’œ AUTHORS πŸ’œ

  • Antonio Murdaca runcom@redhat.com <mailto:runcom@redhat.com>
  • Miloslav Trmac mitr@redhat.com <mailto:mitr@redhat.com>
  • Jhon Honce jhonce@redhat.com <mailto:jhonce@redhat.com>

the legends themselves, we stan 🫢


and that's the whole page, bestie β€” this is skopeo-standalone-verify(1), from the skopeo-standalone-verify(1) manual, and yeah the footer is literally just skopeo-standalone-verify(1)() again with no extra source/version or date info, which is its own kind of iconic tbh πŸ˜­πŸ’– go verify something local, stay safe, mwah 🌸

πŸ“¦ where this page comes from