Crypt::LibScrypt:auth<zef:knarkhov>

Scrypt password hashing using libscrypt. This up-to-date fork from https://github.com/jonathanstowe/Crypt-LibScrypt/.

Synopsis

use Crypt::LibScrypt:ver<0.0.7+>:auth<zef:knarkhov>;

my $password = 'somepa55word';
my $hash     = scrypt-hash($password);

if scrypt-verify($hash, $password) {
    ; # password ok
}

Description

This module provides a binding to the scrypt password hashing functions provided by libscrypt.

It is an alternative to Crypt::SodiumScrypt where one or other of the native libraries is already available or more easily installed. However the two libraries may not be completely interchangeable as the hash may have a different salt prefix. You also can't use both in the same program without some care as both modules export scrypt-hash and scrypt-verify.

The Scrypt algorithm is designed to be prohibitively expensive in terms of time and memory for a brute force attack, so is considered relatively secure. However this means that it might not be suitable for use on resource constrained systems. The cost parameters for scrypt-hash can be tuned - the defaults are a reasonable compromise though.

The hash returned by scrypt-hash is in the format used in /etc/shadow and can be verified by other libraries that understand the Scrypt algorithm ( such as the libxcrypt that is used for password hashing on some Linux distributions.)

Installation

You will need to have C installed for this to work, it is commonly packaged for various Linux distributions, so you should be able to use the usual package management tools. It can also be built from source from https://github.com/technion/libscrypt

Assuming that you have a working installation of Rakudo then you should be able to install this with zef:

zef install Crypt::LibScrypt:auth<zef:knarkhov>

# Or from a local clone

zef install .

Support

If you any suggestions/patches feel free to send them via: https://gitlab.com/pheix/raku-crypt-libscrypt/-/issues

License & Copyright

This is free software please see the LICENSE file in the distribution for details.

Authors and maintainers

Please contact me via Matrix or LinkedIn. Your feedback is welcome at narkhov.pro.

Originally developed and published by Jonathan Stowe in 2021-2022.