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.