Dancer2::Plugin::Auth::Extensible::Unix - authenticate *nix system accounts


An authentication provider for Dancer2::Plugin::Auth::Extensible which authenticates Linux/Unix system accounts.

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


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

get_user_roles $username