CKTIS / Java
MessageDigest — calcular e comparar hashes
MessageDigest calcula hashes unidirecionais de dados. Aprende a selecionar SHA-256, processar bytes, compreender a reposição após digest e comparar resultados com isEqual.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);MessageDigest de java.security calcula um hash unidirecional de bytes, em vez de encriptar dados. SHA-256 devolve 256 bits, ou seja, 32 bytes. O texto hexadecimal é apenas uma representação do resultado; ao converter texto em bytes, seleciona explicitamente uma codificação como StandardCharsets.UTF_8.
MessageDigest.getInstance("SHA-256") obtém uma implementação de um fornecedor de serviços criptográficos. Se o algoritmo pedido não for suportado, é lançada NoSuchAlgorithmException; Java SE 21 exige suporte para SHA-256.
A chamada md.digest(input) numa instância de MessageDigest adiciona input aos dados já acumulados e conclui o cálculo. Para processar dados por blocos, chama update(...) e, em seguida, digest(). Quando o cálculo termina, o objeto regressa ao estado inicial: a chamada seguinte não continua a mensagem anterior.
MessageDigest.isEqual(a, b) compara o comprimento e o conteúdo dos hashes. Não o substituas por ==, que compara as referências dos arrays. Não consideres este método uma garantia incondicional de tempo constante para todos os argumentos e ambientes. Um hash, por si só, não autentica o emissor nem é encriptação.
Esta documentação abrange Java SE 21, o ambiente de execução do repositório. O ambiente de execução em produção não foi atestado.
Exemplos
import java.nio.charset.StandardCharsets;
import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.util.HexFormat;
public class DigestExample {
public static void main(String[] args) throws NoSuchAlgorithmException {
MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] actual = md.digest("abc".getBytes(StandardCharsets.UTF_8));
byte[] expected = HexFormat.of().parseHex(
"ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad");
System.out.println(HexFormat.of().formatHex(actual));
System.out.println(MessageDigest.isEqual(actual, expected));
}
}Resultado
ba7816bf8f01cfea414140de5dae2223b00361a396177a9cb410ff61f20015ad true
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.