shishi_key_from_name(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_key_from_name ✨

okay bestie, pull up a chair because we're doing cryptography today 💅 this is the page for shishi_key_from_name(3) from the shishi manual, and yes it's literally the function that turns a name + password into a key. main character energy fr fr 🔑

🌸 NAME 🌸

shishi_key_from_name — API function

🎀 SYNOPSIS 🎀

#include <shishi.h>

int shishi_key_from_name(Shishi * handle, int32_t type, const char *
name, const char * password, size_t passwordlen, const char * parameter,
Shishi_key ** outkey);

🦋 ARGUMENTS 🦋

  • Shishi * handle — the Shishi library handle, the one you made with shishi_init(). it's giving ✨context✨
  • int32_t type — the type of key. which flavor we're making today 🍓
  • const char * name — the principal name of the user. who is this key for, bestie
  • const char * password — input array containing the password. the secret sauce 🙈
  • size_t passwordlen — length of that input array containing the password. yes we need it, don't skip it
  • const char * parameter — input array with opaque encryption type specific information. opaque!! meaning don't peek, it's type-specific, just pass it along 💜
  • Shishi_key ** outkey — pointer to the structure that will hold the newly created key information. this is where the goods land 👑

💖 DESCRIPTION 💖

so what does it actually do. it creates a brand new Key information structure, and derives the key from the principal name and the password using shishi_key_from_name(). (yes, the function describes itself, iconic behaviour, we love a self-referential moment 🌈)

and the salt? the salt is derived from the principal name by concatenating the decoded realm and the principal. that's the whole vibe. no cap. 🧂✨

🔥 RETURN VALUE 🔥

Returns SHISHI_OK iff successful. that's it, that's the whole check 💀 if it's SHISHI_OK, you ate. if it's not... well.

😭 REPORTING BUGS 😭

found a bug? don't suffer in silence bestie, report bugs 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. periodt 💅

🌈 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 📖

shishi version 1.0.3, and this whole page is shishi_key_from_name(3) — ok bye bestie, go derive some keys responsibly 🫶✨💖

📦 where this page comes from