WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

Mac: Nachrichten mit HMAC authentifizieren

Die Klasse javax.crypto.Mac berechnet mit einem geheimen Schlüssel einen Nachrichtenauthentifizierungscode. Erfahre, wie du HmacSHA256 auswählst, das Objekt mit einem Schlüssel initialisierst und die Berechnung mit doFinal abschließt.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);

Mac aus javax.crypto berechnet einen Nachrichtenauthentifizierungscode (MAC). Damit lässt sich die Integrität von Daten mithilfe eines gemeinsam genutzten geheimen Schlüssels prüfen; die Nachricht wird nicht verschlüsselt. HMAC ist eine MAC-Konstruktion, die auf einer kryptografischen Hashfunktion basiert.

Mac.getInstance("HmacSHA256") wählt eine Implementierung des Algorithmus von den Kryptografie-Providern aus. Mac.init(key) initialisiert das Objekt mit einem Schlüssel. Mac.doFinal(messageBytes) verarbeitet die Bytes und gibt den Tag zurück. Alternativ kannst du über update Datenblöcke übergeben und anschließend doFinal() aufrufen.

Nach Abschluss setzt doFinal den Zustand auf den initialisierten Zustand zurück und behält den Schlüssel für die nächste Nachricht bei. Für einen anderen Schlüssel ist ein erneuter Aufruf von init erforderlich. Eine fehlende Initialisierung führt zu IllegalStateException; ein ungeeigneter Schlüssel kann InvalidKeyException auslösen, ein nicht verfügbarer Algorithmus NoSuchAlgorithmException.

Das Beispiel verwendet einen öffentlichen, kurzen Schlüssel ausschließlich für einen wiederholbaren Test. Verwende ihn nicht in der Produktion: Stelle einen angemessen erzeugten und geschützten geheimen Schlüssel bereit. Der Dokumentationsumfang ist Java SE 21; die Produktionslaufzeit wurde nicht bestätigt.

Beispiele

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));
    }
}

Ergebnis

f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen