Dancer2...er::Unix(3)

💖 NAME 💖

okay so you're looking at the user-contributed Perl documentation for Dancer2...er::Unix(3), and the actual module is Dancer2::Plugin::Auth::Extensible::Unix — it authenticates *nix system accounts. periodt. 💅

🦋 DESCRIPTION 🦋

real talk, bestie: this is an authentication provider for Dancer2::Plugin::Auth::Extensible, and its whole vibe is authenticating Linux/Unix system accounts.

It uses getpwnam and getgrent to read user and group details, and Authen::Simple::PAM to perform authentication via PAM. Unix group membership is used as a reasonable facsimile for roles — and honestly? that seems sensible. ✨

WARNING: in order to use PAM authentication on most modern Linux/UNIX systems the application performing authentication must have read access to the /etc/shadow file. This is a security risk since it can lead to accidental disclosure of sensitive data if you have any path traversal vulnerabilities, etc. We strongly recommend AGAINST using this module and provide it purely as an example. Any use of it IS AT YOUR OWN RISK. You have been warned. 😭🔴

✨ METHODS ✨

🌸 authenticate_user $username, $password

that's the signature, bestie: authenticate_user $username, $password. 💅

🎀 get_user_details $username

Returns information from the passwd file as a hash reference with the following keys: uid, gid, quota, comment, gecos, dir, shell, expire. slay. 💖

🦋 get_user_roles $username

and here's the signature: get_user_roles $username. no extra deets, just that iconic little method. 🌸

mwah 💋 — this page is from perl v5.42.0, dated 2026-08-25, and it's all about Dancer2...er::Unix(3). stay safe out there, bestie 🫶