shishi_ap_tktoptionsasn1usage(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

💖 shishi_ap_tktoptionsasn1usage — the shishi manual, bestie edition 💖

okay so bestie, you're in the shishi manual pages (that's the GNU one, the Kerberos-adjacent legend) and this particular page is all about shishi_ap_tktoptionsasn1usage(3) — an API function. yes, it's a mouthful, we don't make the rules, we just read them 💅

✨ NAME ✨

shishi_ap_tktoptionsasn1usage — it's an API function, that's the whole vibe 🫶

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_ap_tktoptionsasn1usage(Shishi * handle, Shishi_ap ** ap,
Shishi_tkt * tkt, int options, Shishi_asn1 node, const char * field, int
authenticatorcksumkeyusage, int authenticatorkeyusage);

like, that's a lot of parameters, but we're gonna walk through every single one, no cap 🌈

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, allocated by shishi_init(). this is your main character, the one who runs the whole operation 👑
  • Shishi_ap ** ap — a pointer to the new structure that holds all the info about the AP exchange. it's giving "here's where the gossip gets stored" 💌
  • Shishi_tkt * tkt — the ticket to set in the newly created AP. the ticket!! the moment!! 🎟️
  • int options — the AP-REQ options to set in the newly created AP. ✨
  • Shishi_asn1 node — the input ASN.1 structure to store as authenticator checksum data. yes, ASN.1, we love a structured queen 💜
  • const char * field — the field in the ASN.1 structure to use. 🦋
  • int authenticatorcksumkeyusage — the key usage for the checksum in the authenticator. (yes, "cksum", that's the actual spelling, don't come for me 😭)
  • int authenticatorkeyusage — the key usage for the authenticator. periodt. 🍓

🧚 DESCRIPTION 🧚

okay so here's what actually goes down:

Create a new AP exchange using shishi_ap(), and set ticket, options and authenticator checksum data from the DER encoding of the ASN.1 field using shishi_ap_set_tktoptionsasn1usage(). 🛠️

A random session key is added to the authenticator, using the same keytype as the ticket. 🔐 random! session key! same keytype as the ticket! it's giving consistency, it's giving security, it's giving slay.

⭐ RETURN VALUE ⭐

Returns SHISHI_OK iff successful. that's it, that's the return, and honestly we love a function that just tells you it went fine 💖

🐛 REPORTING BUGS 🐛

found a bug? not the vibe, but okay, report it to <bug-shishi@gnu.org>. 🫶

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. fr fr, that's the actual license situation, go off 📜✨

🌈 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. iykyk 📖💅

and that's the page bestie!! this one comes to you from shishi 1.0.3, manual section 3, and yeah the whole thing is shishi_ap_tktoptionsasn1usage(3) — you understood it, you ate, no crumbs left 🎀🦋💜

📦 where this page comes from