shishi_kdcreq_add_padata_tgs(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_kdcreq_add_padata_tgs(3) 💖

okay bestie, sit down, we're doing the shishi manual pages and this one is a whole little function from the shishi library, section 3. yes it's a C API page. yes it's about Kerberos pre-auth data. no you don't need to be scared, i got you 🫶

✨ NAME ✨

shishi_kdcreq_add_padata_tgs — bestie this is an API function, that's literally the whole vibe of the name section 💅

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_kdcreq_add_padata_tgs(Shishi * handle, Shishi_asn1 kdcreq,
       Shishi_asn1 apreq);

the way that include line is just sitting there being iconic ✨

🎀 ARGUMENTS 🎀

  • Shishi * handle — your shishi handle, and no you can't just manifest one out of thin air, it's the one you got from shishi_init(). periodt.
  • Shishi_asn1 kdcreq — the KDC-REQ</> that we're adding PA-DATA to. it's the main character of this operation ngl.
  • Shishi_asn1 apreq — the AP-REQ</> that's getting added as PA-DATA. it's the plus-one. the guest star. the collab. 🦋

💫 DESCRIPTION 💫

so what are we even doing here? we're adding TGS pre-authentication data to a KDC-REQ. that data is an AP-REQ, and it's what authenticates the request — it's giving "let me in, i have credentials" energy 🔥

and how does it do it? literally so simple: this function just DER encodes the AP-REQ and then calls shishi_kdcreq_add_padata() with a SHISHI_PA_TGS_REQ padatatype. that's it. that's the whole lore. no cap. 💅

⭐ RETURN VALUE ⭐

returns SHISHI_OK iff successful. so like, check it, bestie. if it's not SHISHI_OK something went sideways 😭

🙈 REPORTING BUGS 🙈

found a bug? don't be shy, 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.

(translation: go off, remix it, just keep the receipts 💖)

🌈 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, go read it, it's lowkey iconic 📖✨

and that's a wrap on shishi_kdcreq_add_padata_tgs(3) from the shishi manual, version 1.0.3 — mwah, slay, go authenticate something 💅✨🦋

📦 where this page comes from