CKTIS / Java
Mac: berichten authentiseren met HMAC
De klasse javax.crypto.Mac berekent met een geheime sleutel een berichtauthenticatiecode. Lees hoe je HmacSHA256 selecteert, het object met een sleutel initialiseert en de berekening afrondt met doFinal.
Versie: Java SE 21; repository runtime, production runtime not attested
Syntax
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);Mac uit javax.crypto berekent een berichtauthenticatiecode (MAC). Hiermee kun je de integriteit van gegevens controleren met een gedeelde geheime sleutel; het bericht wordt niet versleuteld. HMAC is een MAC-constructie op basis van een cryptografische hashfunctie.
Mac.getInstance("HmacSHA256") selecteert een implementatie van het algoritme bij de cryptografische providers. Mac.init(key) initialiseert het object met een sleutel. Mac.doFinal(messageBytes) verwerkt de bytes en geeft de tag terug. Je kunt ook blokken aanleveren via update en daarna doFinal() aanroepen.
Na afloop herstelt doFinal de geïnitialiseerde toestand en behoudt het de sleutel voor het volgende bericht. Voor een andere sleutel moet je opnieuw init aanroepen. Ontbrekende initialisatie veroorzaakt IllegalStateException; een ongeschikte sleutel kan InvalidKeyException veroorzaken en een niet-beschikbaar algoritme veroorzaakt NoSuchAlgorithmException.
Het voorbeeld gebruikt een openbare, korte sleutel uitsluitend voor een herhaalbare test. Gebruik deze niet in productie: zorg voor een passend gegenereerde en beveiligde geheime sleutel. De documentatie heeft betrekking op Java SE 21; de productie-runtime is niet bevestigd.
Voorbeelden
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));
}
}Resultaat
f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.