SIGSUM-TOKEN-CREATE(1)

📦
version 0.14.1 · 4 versions
, in ubuntu stonking

✨ SIGSUM-TOKEN-CREATE ✨

okay bestie, quick vibe check: this is the sigsum-token-create page, section 1 of the manual (User Commands energy 💅). It's here to help you create a rate-limit token, and honestly? It's giving "small tool, big purpose." Let's get into it. 🎀

🌸 NAME 🌸

sigsum-token-create — create rate-limit token

🦋 SYNOPSIS 🦋

sigsum-token create [-d domain-name] [--help] [-k key-file] [-l key-file] [-o output-file]

💖 DESCRIPTION 💖

So here's the tea 🍓: you're creating a token for submissions to the the given log. (Yes, the original page really does say "the the" — we're keeping it, no cap, that's just the lore.)

What even is this token? It's essentially a signature on the log's public key. That's it, that's the whole thing. ✨

And a lil bonus: if you provide a domain name (that's the -d option, iykyk), it outputs a complete HTTP header. Iconic behavior, honestly. 👑

💅 OPTIONS 💅

  • -d, --domain=domain-name — The domain name where the rate-limit public-key lives as a TXT record. Heads up though: without any "_sigsum_v1." prefix. Don't add it, bestie, it's not the move. 🙈
  • --help — Display help. Simple. Clean. A classic. 💅
  • -k, --signing-key=key-file — The private key, in OpenSSH format, that you're signing the token with. Alternatively, you can pass a corresponding public key where the private part gets accessed through the SSH agent protocol. Oh and — this one is required. No signing key, no token. Periodt. 🔥
  • -l, --log-key=key-file — The log's public key, in OpenSSH format. Also required. Yeah, you need both. That's the assignment. 😭
  • -o, --output=output-file — Store the output in a file. Want it in a file instead of staring at your terminal? Say less. 🫶

⭐ RETURN CODES ⭐

A non-zero return code means failure. So if you see a non-zero, something went wrong. Sad girl hours. 😭

🌈 CONTACT 🌈

Wanna slide into the sigsum DMs? Totally valid. 💌

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 hang out, we don't bite. 🦋

🙈 REPORTING BUGS 🙈

Found a bug? Not the vibe, but let's fix it together. ✨

Use the issue tracker located at:

https://git.glasklar.is/sigsum/core/sigsum-go/-/issues

And if you don't have a GitLab account? No stress. Send an email to sigsum-core-sigsum-go-issues@incoming.glasklar.is and then just wait for a maintainer to make the issue public. Patience, bestie, it's a whole process. 🧚

🎀 SEE ALSO 🎀

And that's the whole page, bestie! 💜

For the record-files: this is sigsum-token create version 0.14.1-2, and the page is dated June 2026. Go forth and create those rate-limit tokens. Slay. 👑✨

📦 where this page comes from