argon2
O namespace argon2 fornece hashing de senhas Argon2id com parâmetros configuráveis.
import { CryptoError, argon2, jwt, rand } from "tyrus:crypto";
interface SessionClaims {
role: string;
}
// Password hashing
match (await argon2.hash("my-password")) {
Ok(hash) => {
match (await argon2.verify(hash, "my-password")) {
Ok(valid) => { print(valid); } // true
Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_*
}
match (argon2.needsRehash(hash)) {
Ok(migrate) => { print(migrate); } // false
Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_INVALID_HASH
}
}
Err(error) => { printError(error.code); } // ERR_CRYPTO_ARGON2_*
}
// JWT HMAC requires at least 32 bytes of secret material.
try {
const key: string = "0123456789abcdef0123456789abcdef";
const inputClaims: SessionClaims = { role: "reader" };
const signed: Result<string, CryptoError> = jwt.sign(inputClaims, key, { algorithm: "HS384", expiresIn: "1h", subject: "123" });
match (signed) {
Ok(token) => {
const verified: Result<SessionClaims, CryptoError> = jwt.verify<SessionClaims>(token, key, { algorithms: ["HS384"], subject: "123" });
match (verified) {
Ok(claims) => {
print(claims.role); // reader
}
Err(error) => { printError(error.code); } // ERR_CRYPTO_*
}
}
Err(error) => { printError(error.code); } // ERR_CRYPTO_*
}
} catch (error: Error) {
printError(error.message);
}
// Secure random
const id: string = rand.uuidv7();
try {
const bytes: u8[] = rand.randomBytes(32);
print(bytes.length);
} catch (error: Error) {
printError(error.message);
}Funções
| Função | Assinatura |
|---|---|
argon2.hash | (string | u8[], options?) => Promise<Result<string, CryptoError>> |
argon2.verify | (string, string | u8[], options?) => Promise<Result<boolean, CryptoError>> |
argon2.needsRehash | (string) => Result<boolean, CryptoError> |
argon2.hash cumpre com Ok(hash) em caso de sucesso e Err(CryptoError) para entrada ou opções inválidas, concorrência esgotada, falha do gerador aleatório ou falha do worker. Usa Argon2id com salt aleatório de 16 bytes, saída de 32 bytes e o perfil padrão m=65536, t=3, p=4. As opções podem definir type: "argon2id", memoryCost de 19.456 a 262.144 KiB, timeCost de 2 a 10, parallelism de 1 a 16 e um secret binário não vazio de até 1.024 bytes. Senhas textuais e binárias são limitadas a 1.024 bytes.
argon2.verify cumpre com Ok(matches) para um hash válido e Err(CryptoError) para strings PHC malformadas, parâmetros inválidos, pepper obrigatório ausente, concorrência esgotada ou falha do worker. Limita strings PHC a 4 KiB e valida parâmetros não confiáveis antes de alocar trabalho. Um hash com pepper contém um marcador autenticado não secreto; omitir secret retorna ERR_CRYPTO_ARGON2_PEPPER_REQUIRED, enquanto um secret incorreto retorna Ok(false). Armazene e rotacione o pepper separadamente dos hashes de senha.
argon2.needsRehash retorna Ok(true) quando a string PHC é válida, mas seu algoritmo, versão, parâmetros, tamanho do salt ou tamanho da saída diferem do perfil padrão. Strings PHC inválidas ou grandes demais retornam Err(CryptoError) com o código ERR_CRYPTO_ARGON2_INVALID_HASH.
Limite de concorrência
No máximo quatro operações Argon2 executam simultaneamente. Chamadas adicionais cumprem com Err(CryptoError) e o código ERR_CRYPTO_ARGON2_BUSY.
