Sympa::Tools::SMIME(3Sympa)

🎀 NAME 🎀

Sympa::Tools::SMIME — the toolbox for S/MIME messages and X.509 certificates, from the sympa 6.2.80 manual page (section 3Sympa, bestie, in case you were wondering).

---

✨ DESCRIPTION ✨

Okay so this module is giving "I handle your certs and your signed mail" energy and honestly? Iconic.

💅 Functions

🔑 find_keys ( $that, $operation )

Finds the right S/MIME keys/certs for $operation of $that. Like, it literally goes shopping for the correct key situation for you.

$operation can be:

• 'sign' — hands you back the preferred signing key/cert. main character of signatures fr.
• 'decrypt' — hands you back a list of possible decryption keys/certs. choices!! we love options 🫶
• 'encrypt' — hands you back the preferred encryption key/cert.

Returns "($certs, $keys)".

Heads up bestie, the shapes are different depending on the vibe: for 'sign' and 'encrypt', these are strings containing the absolute filename. For 'decrypt', these are arrayrefs containing absolute filenames. Don't mix them up or it's giving 💀.

---

📜 parse_cert ( "text"|"file" => $content )

Parses an X.509 certificate. She's reading the whole thing, no skimming. 👑

Options:

• "file" => $filename
• "text" => $text — specifies PEM-encoded certificate.

Returns a hashref containing these items:

• {email} — hashref with email addresses from cert as keys.
• {emails} — arrayref with email addresses from cert. This was added on Sympa 6.2.67b. ✨ new-ish drop alert ✨
• {subject} — distinguished name.
• {purpose} — hashref containing:
  • {enc} — true if v3 purpose is encryption.
  • {sign} — true if v3 purpose is signing.

TBD.

If parsing failed, returns undef. 😭 she said nope, nothing, void, silence.

---

🌸 HISTORY 🌸

TBD.

---

And that's the whole page, bestie! This was sympa 6.2.80, dated 2026-10-19, and the manual page is Sympa::Tools::SMIME(3Sympa). Go forth and certify your little heart out! 🦋✨💖