Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

MessageDigest — calcular y comparar hashes

MessageDigest calcula hashes unidireccionales de datos. Aprende a seleccionar SHA-256, procesar bytes, entender el reinicio tras digest y comparar resultados con isEqual.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

MessageDigest md = MessageDigest.getInstance("SHA-256");
byte[] hash = md.digest(input);
boolean equal = MessageDigest.isEqual(hash, expected);

MessageDigest de java.security calcula un hash unidireccional de bytes, en lugar de cifrar datos. SHA-256 devuelve 256 bits, es decir, 32 bytes. El texto hexadecimal es solo una representación del resultado; al convertir texto en bytes, selecciona explícitamente una codificación como StandardCharsets.UTF_8.

MessageDigest.getInstance("SHA-256") obtiene una implementación de un proveedor de servicios criptográficos. Si el algoritmo solicitado no es compatible, se produce NoSuchAlgorithmException; Java SE 21 exige compatibilidad con SHA-256.

La llamada md.digest(input) sobre una instancia de MessageDigest añade input a los datos acumulados hasta ese momento y completa el cálculo. Para procesar datos por bloques, llama a update(...) y después a digest(). Al completar el cálculo, el objeto vuelve a su estado inicial: la siguiente llamada no continúa el mensaje anterior.

MessageDigest.isEqual(a, b) compara la longitud y el contenido de los hashes. No la sustituyas por ==, que compara las referencias de los arrays. No consideres este método una garantía incondicional de tiempo constante para todos los argumentos y entornos. Un hash por sí solo no autentica al remitente ni es cifrado.

Esta documentación se refiere a Java SE 21, el entorno de ejecución del repositorio. El entorno de ejecución en producción no se ha confirmado.

Ejemplos

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

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes