shishi_apreq_set_authenticator(3)

💖 shishi_apreq_set_authenticator — from the shishi manual, section 3 💖

okay bestie, sit down, we're doing crypto library lore today ✨ this one lives in the shishi manual, section 3, and it's literally the little function that tucks your encrypted authenticator into place. it's giving backstage-pass energy, no cap.

---

🌸 NAME 🌸

shishi_apreq_set_authenticator — an API function. yes that's the whole name section, she's lowkey mysterious like that 💅

---

✨ SYNOPSIS ✨

#include <shishi.h>

int shishi_apreq_set_authenticator(Shishi * handle, Shishi_asn1 apreq,
int32_t etype, uint32_t kvno, const char * buf, size_t buflen);

there she is. copy her exactly, don't freestyle, i'm begging 🙈

---

🎀 ARGUMENTS 🎀

• Shishi * handle — your shishi handle, the one you got from shishi_init(). she's the main character, everything runs through her 👑
• Shishi_asn1 apreq — the AP-REQ you're adding the authenticator field to. this is the glow-up target 💖
• int32_t etype — the encryption type used to encrypt the authenticator. which flavor of crypto we're using, basically 🧚
• uint32_t kvno — the version of the key used to encrypt the authenticator. key vintages matter, periodt 🔑
• const char * buf — input array holding the encrypted authenticator. the goods, in a buffer 🎁
• size_t buflen — size of that input array with the encrypted authenticator. how many bytes of goods we're talking 🌈

---

💜 DESCRIPTION 💜

so what she does: she sets the encrypted authenticator field in the AP-REP. that's the job, that's the whole vibe.

and like, where does that encrypted data come from? usually you make it by calling shishi_encrypt() on the DER encoded authenticator. that's the classic route, the DIY path, very craft-core 🎨

but ngl, if you're trying to save time, you might wanna just use shishi_apreq_add_authenticator() instead — because she calculates the encrypted data and calls this function, all in one step. one function, one call, no extra chores. it's giving efficiency, it's giving convenience, it's giving "bestie why are you doing this by hand" 😭✨

---

⭐ RETURN VALUE ⭐

returns SHISHI_OK on success. that's the good ending, we love her 🫶

---

🦋 REPORTING BUGS 🦋

found a bug? tell the people! report bugs to <bug-shishi@gnu.org>.

GNU Shishi home page: http://www.gnu.org/software/shishi/

General help using GNU software: http://www.gnu.org/gethelp/

fr fr, if something's broken, say something — silence helps nobody 🙈

---

🌸 COPYRIGHT 🌸

Copyright © 2002-2022 Simon Josefsson.

Copying and distribution of this file, with or without modification, are permitted in any medium without royalty provided the copyright notice and this notice are preserved.

(translation: use it, share it, just keep the receipt 💖)

---

🌈 SEE ALSO 🌈

The full documentation for shishi is maintained as a Texinfo manual. If the info and shishi programs are properly installed at your site, the command

info shishi

should give you access to the complete manual. go read her, she's thorough 👑

---

and that's the page, bestie!! 🎀 this was shishi version 1.0.3, page shishi_apreq_set_authenticator(3) — go forth, set those authenticators, stay iconic 💅✨