shishi_authorized_p(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_authorized_p — it's an API function, bestie 💅 (from the shishi manual, section 3, if you were wondering where we are rn)

🌸 SYNOPSIS 🌸

#include <shishi.h>

int shishi_authorized_p(Shishi * handle, Shishi_tkt * tkt, const char *
authzname);

🎀 ARGUMENTS 🎀

  • Shishi * handle — the shishi handle, and no you can't just make one up, it's the one allocated by shishi_init(). 🫶
  • Shishi_tkt * tkt — an input variable carrying the ticket info. it's giving "the receipts" fr.
  • const char * authzname — the authorization name. that's the name we're asking about. 👑

🦋 DESCRIPTION 🦋

okay so this is a simplistic authorization check — key word simplistic, bestie, don't come for her — that checks authzname against the encrypted client principal name sitting inside the ticket. 🔥

Here's the tea on the two auth types:

  • For the "basic" authentication type, the principal name must coincide with authzname. like, they have to match. that's it. no wiggle room, no notes. 💀
  • The "k5login" authentication type attempts the MIT/Heimdal method of parsing the file "~/.k5login" to find additional equivalence names. so it's lowkey like "okay you're not literally the same name but the k5login file says you're equivalent, so slay." ✨

💖 RETURN VALUE 💖

  • Returns 1 if authzname is authorized for services by the encrypted principal 🎉
  • Returns 0 otherwise 🙈

that's it. a lil 1 or a lil 0. binary queen. 💅

😭 REPORTING BUGS 😭

Found a bug? not the vibe, but pls report it to <bug-shishi@gnu.org> so it can get fixed 🫶

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. (yes bestie, you may copy it, royalty-free, iconic behavior 🌈)

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

and that's the whole page, bestie 💜 that was shishi_authorized_p(3) from the shishi 1.0.3 manual — stan a secure authentication library fr fr, mwah 🎀✨

📦 where this page comes from