Crypto functions
These functions can be used when hashing data, encrypting data, and for securely authenticating users into the database.
crypto::blake3
Available since: v2.0.0
The crypto::blake3 function returns the blake3 hash of the input value.
API DEFINITION
crypto::blake3(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::blake3("tobie");
crypto::joaat
Available since: v3.0.0
The crypto::joaat function returns the joaat hash of the input value.
API DEFINITION
crypto::joaat(string) -> number
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::joaat("tobie");
crypto::md5
The crypto::md5 function returns the md5 hash of the input value.
API DEFINITION
crypto::md5(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::md5("tobie");
crypto::sha1
The crypto::sha1 function returns the sha1 hash of the input value.
API DEFINITION
crypto::sha1(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::sha1("tobie");
crypto::sha256
The crypto::sha256 function returns the sha256 hash of the input value.
API DEFINITION
crypto::sha256(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::sha256("tobie");
crypto::sha512
The crypto::sha512 function returns the sha512 hash of the input value.
API DEFINITION
crypto::sha512(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::sha512("tobie");
"39f0160c946c4c53702112d6ef3eea7957ea8e1c78787a482a89f8b0a8860a20ecd543432e4a187d9fdcd1c415cf61008e51a7e8bf2f22ac77e458789c9cdccc"
crypto::argon2::compare
The crypto::argon2::compare function compares a hashed-and-salted argon2 password value with an unhashed password value.
API DEFINITION
crypto::argon2::compare(string, $against: string) -> bool
The following example shows this function, and its output, when used in a RETURN statement:
LET $hash = "$argon2id$v=19$m=4096,t=3,p=1$pbZ6yJ2rPJKk4pyEMVwslQ$jHzpsiB+3S/H+kwFXEcr10vmOiDkBkydVCSMfRxV7CA";
LET $pass = "this is a strong password";
RETURN crypto::argon2::compare($hash, $pass);
crypto::argon2::generate
The crypto::argon2::generate function hashes and salts a password using the argon2 hashing algorithm.
At this time, there is no way to customize the parameters for this function. This applies to: memory, iterations and parallelism.
API DEFINITION
crypto::argon2::generate(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::argon2::generate("this is a strong password");
"$argon2id$v=19$m=4096,t=3,p=1$pbZ6yJ2rPJKk4pyEMVwslQ$jHzpsiB+3S/H+kwFXEcr10vmOiDkBkydVCSMfRxV7CA"
crypto::bcrypt::compare
The crypto::bcrypt::compare function compares a hashed-and-salted bcrypt password value with an unhashed password value.
API DEFINITION
crypto::bcrypt::compare(string, $against: string) -> bool
The following example shows this function, and its output, when used in a RETURN statement:
LET $hash = "$2b$12$OD7hrr1Hycyk8NUwOekYY.cogCICpUnwNvDZ9NiC1qCPHzpVAQ9BO";
LET $pass = "this is a strong password";
RETURN crypto::bcrypt::compare($hash, $pass);
true
crypto::bcrypt::generate
The crypto::bcrypt::generate function hashes and salts a password using the bcrypt hashing algorithm.
At this time, there is no way to customize the work factor for bcrypt.
API DEFINITION
crypto::bcrypt::generate(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::bcrypt::generate("this is a strong password");
"$2b$12$OD7hrr1Hycyk8NUwOekYY.cogCICpUnwNvDZ9NiC1qCPHzpVAQ9BO"
crypto::pbkdf2::compare
The crypto::pbkdf2::compare function compares a hashed-and-salted pbkdf2 password value with an unhashed password value.
API DEFINITION
crypto::pbkdf2::compare(string, $against: string) -> bool
The following example shows this function, and its output, when used in a RETURN statement:
LET $hash = "$pbkdf2-sha256$i=10000,l=32$DBURRPJODKEt0IId1Lqe+w$Ve8Z00mibHDSKLbyKTceEBBcDpGoK0AEUl7QzDTIec4";
LET $pass = "this is a strong password";
RETURN crypto::pbkdf2::compare($hash, $pass);
true
crypto::pbkdf2::generate
The crypto::pbkdf2::generate function hashes and salts a password using the pbkdf2 hashing algorithm.
At this time, there is no way to customize the number of iterations for pbkdf2.
API DEFINITION
crypto::pbkdf2::generate(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::pbkdf2::generate("this is a strong password");
"$pbkdf2-sha256$i=10000,l=32$DBURRPJODKEt0IId1Lqe+w$Ve8Z00mibHDSKLbyKTceEB"
crypto::scrypt::compare
The crypto::scrypt::compare function compares a hashed-and-salted scrypt password value with an unhashed password value.
API DEFINITION
crypto::scrypt::compare(string, $against: string) -> bool
The following example shows this function, and its output, when used in a RETURN statement:
LET $hash = "$scrypt$ln=15,r=8,p=1$8gl7bipl0FELTy46YJOBrw$eRcS1qR22GI8VHo58WOXn9JyfDivGo5yTJFvpDyivuw";
LET $pass = "this is a strong password";
RETURN crypto::scrypt::compare($hash, $pass);
true
crypto::scrypt::generate
The crypto::scrypt::generate function hashes and salts a password using the scrypt hashing algorithm.
At this time, there is no way to customize the parameters for this function. This applies to: cost parameter, block size and parallelism.
API DEFINITION
crypto::scrypt::generate(string) -> string
The following example shows this function, and its output, when used in a RETURN statement:
RETURN crypto::scrypt::generate("this is a strong password");
"$scrypt$ln=15,r=8,p=1$8gl7bipl0FELTy46YJOBrw$eRcS1qR22GI8VHo58WOXn9JyfDivGo5yTJFvpDyivuw"
