shishi_ap_rep_verify_der(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_rep_verify_der — from the shishi manual, section 3 💖

okay bestie, sit down, we're doing Kerberos-adjacent cryptography and honestly? it's giving ✨responsible adult✨. This one lives in the shishi manual, section 3, and it's about checking that somebody's AP-REP is legit.

✨ NAME ✨

shishi_ap_rep_verify_der — it's an API function, babes. That's the whole vibe. API function.

🦋 SYNOPSIS 🦋

#include <shishi.h>

int shishi_ap_rep_verify_der(Shishi_ap * ap, char * der, size_t derlen);

like. look at her. three arguments, returns an int, no notes. 💅

🎀 ARGUMENTS 🎀

  • Shishi_ap * ap — this is the structure that holds all the info about the AP exchange. she's the main character, she holds the lore. 👑
  • char * der — input array stuffed with a DER encoded AP-REP. raw bytes, no vibes, just data. 🌸
  • size_t derlen — the length of that input array with the DER encoded AP-REP. yes she needs to know how long it is, don't skip this one. 😭

🌈 DESCRIPTION 🌈

So here's the tea: this function DER decodes the AP-REP, sets it into the AP exchange using shishi_ap_rep_der_set(), and then verifies it using shishi_ap_rep_verify(). Three steps, one call, no cap. 🫶

it's lowkey just a little wrapper doing the decode → set → verify pipeline for you so you don't have to do it yourself. iconic behaviour honestly.

💀 RETURN VALUE 💀

Returns SHISHI_OK, or SHISHI_APREP_VERIFY_FAILED, or just an error — like, an unspecified one, the mystery flavour. 🙈

bestie if you get SHISHI_APREP_VERIFY_FAILED that means the verification did not pass. do not proceed. do not pass go. 🚨

🐛 REPORTING BUGS 🐛

Found a bug? (not me manifesting one 💀) Report bugs to <bug-shishi@gnu.org>.

they're nice, they'll help you, 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.

(that's the license bestie, keep the notice, it's literally the rules ✨)

🌟 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.

like, all the lore is in there. go read it. 📖✨

and that's the whole page, bestie!! this was shishi version 1.0.3, page shishi_ap_rep_verify_der(3) — mwah, go verify some AP-REPs, you absolute legend 💜🧚‍♀️

📦 where this page comes from