CKTIS / Java
Mac: autenticar mensajes con HMAC
La clase javax.crypto.Mac calcula un código de autenticación de mensajes mediante una clave secreta. Aprende a seleccionar HmacSHA256, inicializar el objeto con una clave y finalizar el cálculo con doFinal.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);Mac de javax.crypto calcula un código de autenticación de mensajes (MAC). Permite comprobar la integridad de los datos mediante una clave secreta compartida; no cifra el mensaje. HMAC es una construcción MAC basada en una función hash criptográfica.
Mac.getInstance("HmacSHA256") selecciona una implementación del algoritmo entre los proveedores criptográficos. Mac.init(key) inicializa el objeto con una clave. Mac.doFinal(messageBytes) procesa los bytes y devuelve la etiqueta. Como alternativa, puedes proporcionar bloques mediante update y después llamar a doFinal().
Al terminar, doFinal restaura el estado inicializado y conserva la clave para el siguiente mensaje. Para usar otra clave hay que volver a llamar a init. Si no se inicializa, se produce IllegalStateException; una clave inadecuada puede producir InvalidKeyException, y un algoritmo no disponible produce NoSuchAlgorithmException.
El ejemplo usa una clave pública y corta únicamente para una prueba reproducible. No la uses en producción: proporciona una clave secreta generada y protegida adecuadamente. El alcance de la documentación es Java SE 21; el entorno de ejecución de producción no ha sido verificado.
Ejemplos
import java.nio.charset.StandardCharsets;
import java.util.HexFormat;
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
public class MacExample {
public static void main(String[] args) throws Exception {
// Public test key only; never use it in production.
byte[] keyBytes = "key".getBytes(StandardCharsets.UTF_8);
byte[] message = "The quick brown fox jumps over the lazy dog"
.getBytes(StandardCharsets.UTF_8);
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(new SecretKeySpec(keyBytes, "HmacSHA256"));
byte[] tag = mac.doFinal(message);
System.out.println(HexFormat.of().formatHex(tag));
}
}Resultado
f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
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.