The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

Name

Connector::Builtin::Authentication::PasswordScheme

Description

Lightweight connector to check passwords against a password file holding username/password pairs where the password is encrypted using a salted hash. Password notation follows RFC2307 ({scheme}saltedpassword) but we support only salted schemes: smd5, ssha and crypt.

Usage

The username is the first component of the path, the password needs to be passed in the extended parameters using the key password.

Example:

   $connector->get('username', {  password => 'mySecret' } );

Return values

1 if the password matches, 0 if the user is found but the password does not match and undef if the user is not found.

The connector will die if the password file is not readable or if one of the parameters is missing.

Limitations

Usernames are limited to [a-zA-Z0-9_\-\.], invalid names are treated as not found.