hash

Calcula o hash de uma string com o algoritmo escolhido.

Sintaxe

string hash ( string algoritmo, string dados [, table opcoes ] )

Parâmetros

Nome	Tipo	Padrão	Descrição
algoritmo	string	—	Nome do algoritmo, sem diferenciar maiúsculas de minúsculas.
dados	string	—	Conteúdo a resumir.
opcoes	table	—	Só usada por hmac.

Algoritmos aceitos

Nome	Tamanho do resultado
md5	32 caracteres
sha1	40 caracteres
sha224	56 caracteres
sha256	64 caracteres
sha384	96 caracteres
sha512	128 caracteres
hmac	depende do algoritmo interno escolhido

Para hmac, a tabela opcoes precisa trazer:

Campo	Tipo	Descrição
key	string	Chave secreta. Não pode ser vazia.
algorithm	string	Algoritmo interno: um dos nomes da tabela acima, exceto hmac.

Retorno

O hash em hexadecimal minúsculo, ou false se o algoritmo for desconhecido, ou se hmac for pedido sem chave ou sem um algoritmo interno válido.

Nota

hash("md5", texto) devolve o mesmo hash que md5(texto), só que em minúsculas. Se você compara os dois, normalize antes com string.lower.

Exemplo

-- assinando um corpo de requisição antes de enviá-lo
local assinatura = hash("hmac", corpo, {
    key = "minha-chave-secreta",
    algorithm = "sha256"
})

Veja também

• md5 — Calcula o hash MD5 de uma string.
• sha256 — Calcula o hash SHA-256 de uma string.
• teaEncode — Cifra uma string com XTEA e devolve o resultado em Base64.
• teaDecode — Desfaz um teaEncode.
• encodeString — Codifica ou cifra uma string com o algoritmo escolhido.
• decodeString — Desfaz um encodeString.
• generateKeyPair — Gera um par de chaves RSA.