shishi_apreq_add_authenticator(3)

📦
version 1.0.3 · 2 versions
  • 1.0.3 · debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking (latest)
  • 1.0.2 · ubuntu jammy
, in debian bookworm, debian trixie, nixos 26.05, nixpkgs unstable, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

shishi_apreq_add_authenticator — bestie, it's an API function ✨ (from the shishi manual, section 3, iykyk)

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_apreq_add_authenticator(Shishi * handle, Shishi_asn1 apreq,
Shishi_key * key, int keyusage, Shishi_asn1 authenticator);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and no you can't just make one up, it's gotta come from shishi_init(). periodt.
  • Shishi_asn1 apreq — the AP-REQ you're adding the authenticator field to. this is the main character of the whole operation, lowkey.
  • Shishi_key * key — the key you're gonna use for encryption. (the original says "key to to use for encryption" and honestly? relatable typo energy, but I'm telling you it's the encryption key 💅)
  • int keyusage — the cryptographic key usage value that goes into the encryption. yes it matters, no you can't skip it.
  • Shishi_asn1 authenticator — the authenticator itself, and it's gotta be allocated by shishi_authenticator() first or it's not valid.

✨ DESCRIPTION ✨

Okay so here's the tea 🫖: this function takes your DER encoded authenticator, encrypts it using key, and stores the result in the AP-REQ. That's it. That's the whole vibe. slay.

🔥 RETURN VALUE 🔥

Returns SHISHI_OK iff it worked. if you get anything else, something went sideways, bestie 😭

💀 REPORTING BUGS 💀

Found a bug? Not me gatekeeping — report it to <bug-shishi@gnu.org> fr fr.

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. (generous king behavior, we love to see it)

🌈 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 it, it's giving encyclopedia but make it cute.

and that's a wrap, bestie 💖 this page is from shishi 1.0.3, the shishi_apreq_add_authenticator(3) manual page. take care of her, she's iconic 🎀✨

📦 where this page comes from