dkimsign(1)

✨ dkimsign ✨

okay so bestie, welcome to dkimsign(1) from the General Commands Manual 💖 this is the little script that signs your mail with DKIM and honestly? she's iconic for it 💅

🌸 NAME 🌸

dkimsign — a script for DKIM signing messages on stdin 🫶

🎀 VERSION 🎀

0.7.0 ✨ (yes queen, we're on 0.7.0, periodt)

💖 DESCRIPTION 💖

so here's the vibe: dkimsign is a filter. It reads an RFC822 message on standard input, and then writes that same message back out on standard output — except with a DKIM-Signature line prepended to it. that's it. that's the whole job. no notes. 🔥

like, in on stdin, out on stdout, one extra header at the top, main character energy only 🌈

🦋 USAGE 🦋

here's exactly how you run her:

usage: dkimsign.py [-h] [--hcanon {simple,relaxed}]
                   [--bcanon {simple,relaxed}]
                   [--signalg {rsa-sha256,ed25519-sha256,rsa-sha1}]
                   [--identity IDENTITY]
                   selector domain privatekeyfile

🌟 mandatory positional arguments 🌟

these ones are not optional bestie, you have to give her all three:

• selector — the selector, fr fr, she needs it
• domain — the domain, obviously 💁
• privatekeyfile — your private key file, keep it safe, iykyk 🔐

💅 optional arguments 💅

• -h, --help — shows this help message and exits, the classic 🎀
• --hcanon {simple,relaxed} — header canonicalization algorithm: default is relaxed
• --bcanon {simple,relaxed} — body canonicalization algorithm: default is simple
• --signalg {rsa-sha256,ed25519-sha256,rsa-sha1} — signature algorithm: default is rsa-sha256
• --identity IDENTITY — optional value for the i= tag

note bestie: the header canon defaults to relaxed but the body canon defaults to simple. don't mix them up, i'm literally begging 🙈

👑 AUTHORS 👑

the original version of dkimsign was written by Greg Hewgill <greg@hewgill.com> 🌸

it has been substantially rewritten by Scott Kitterman <scott@kitterman.com> ✨

this man-page was created by Scott Kitterman <scott@kitterman.com> and is licensed under the same terms as dkimpy 📜

and that's the whole page, bestie!! this cutie was dated 2018-02-05, so like, she's been serving DKIM signatures since before some of us could drive 💀 anyway ily, go sign some mail, slay 💖✨🦋