SIGSUM-KEY-TO-VKEY(1)

📦
version 0.14.1 · 4 versions
, in ubuntu stonking

SIGSUM-KEY-TO-VKEY(1) 💖

okay bestie so real talk, the manual page here is sigsum-key-to-vkey(1) — a User Commands moment — and it's literally just a lil glow-up station for your keys ✨

🎀 NAME 🎀

sigsum-key-to-vkey — convert public key in OpenSSH format to vkey format

✨ SYNOPSIS ✨

sigsum-key to-vkey [--help] [-k key-file] [-n key-name] [-o output-file]
[-t type]

🦋 DESCRIPTION 🦋

so what we're doing here is: read a public key in OpenSSH format and output it in vkey format. that's it, that's the whole vibe 💅

the public key comes in on stdin and the output gets written on stdout. wanna switch that up? the -k and -o options are right there, go off 👑

unless you hand over the -n option, it's assumed that a vkey for a sigsum log server is what you're asking for. meaning: the vkey name defaults to the log's origin line sigsum.org/v1/tree/<key hash> and the type defaults to ed25519 (that's the -t one).

and if you wanna encode vkeys for witness cosigning, that's what -n and -t are bringing to the table 🫶 the best practise (yes, bestie, that's how the page spells it, and it's giving ✨) is to use a schemaless URL for the name — like, foo.example.org and example.org/bar would be two good examples, no cap.

🌸 OPTIONS 🌸

  • --help — show usage message and exit. short, sweet, iconic.
  • -k, --key=key-file — public key in OpenSSH format
  • -n, --name=key-name — name of the public key
  • -o, --output=output-file — public key in vkey format
  • -t, --type=type — available types: ed25519, cosignature/v1 [ed25519]
wait, that bracketed [ed25519] at the end of -t? that's the default, queen. don't forget it 🍓

💜 RETURN CODES 💜

a non-zero return code is used to indicate failure. so if it's not zero, something went wrong and we're being dramatic about it 😭

🧚 CONTACT 🧚

send an email to the sigsum-general mailing list at sigsum-general@lists.sigsum.org. you can also reach out in room #sigsum at OFTC.net and matrix.org. come say hi, we don't bite 🫶

🙈 REPORTING BUGS 🙈

use the issue tracker located at https://git.glasklar.is/sigsum/core/sigsum-go/-/issues. and if you wanna file issues but don't have a GitLab account? no stress — send an email to sigsum-core-sigsum-go-issues@incoming.glasklar.is and wait for a maintainer to make the issue public. patience is a vibe, fr fr ✨

🌈 SEE ALSO 🌈

sigsum-key-from-hex(1) sigsum-key-from-vkey(1) sigsum-key-generate(1) sigsum-key-sign(1) sigsum-key-to-hash(1) sigsum-key-to-hex(1) sigsum-key-to-vkey(1) sigsum-key-verify(1) sigsum-monitor(1) sigsum-policy(1) sigsum-submit(1) sigsum-token(1) sigsum-tools(5) sigsum-verify(1)

and that's the whole page, bestie 💖 this was sigsum-key to-vkey version 0.14.1-2, dated June 2026. slay, go convert some keys 👑🦋✨

📦 where this page comes from