Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes