hash scheme, passwd, params

SCHEME is one of sha (SHA1), md5 (MD5), crypt (Unix crypt), smd5 (salted MD5), ssha (salted SHA1), ssha (salted SHA256) or argon2.

It returns a hash in the format "{SCHEME}encrypted_string", or undef if no hash could be computed.

For argon2 the return format is unencoded token generated by Crypt::Argon2 "$argon...".

For all algorithms except argon2, params can be the encoded part of a prior call to hash which effectively extracts the salt from the given string which will result in the same encoded string if the same password was given. The default is to create a random salt of suitable size.

For argon2 params must be a hashref with the following options, options are passed as-is to Crypt::Argon2::argon2id_pass, details on the options can be found there.

salt

A literal value to be used as salt. The class does not make any checks so make sure the salt has enough entropy.

saltbytes

Number of bytes to generate a salt, the default is 16 bytes. Is overridden by salt.

time

argon2 time cost factor, default is 3.

memory

argon2 memory cost factor, expects a memory size in k, M or G, default is 32M.

p

paralellism factor, default is 1.

tag

tag size, default is 16.

check

The digest must have the format: "{SCHEME}encrypted_string" or must start with $argon2

SCHEME is one of sha (SHA1), md5 (MD5), crypt (Unix crypt), smd5 (encrypted MD5) or ssha (encrypted SHA1).

It returns 1 if the password matches the digest, 0 otherwise.