CKTIS / Java
Mac: provjera autentičnosti poruka pomoću HMAC-a
Klasa javax.crypto.Mac izračunava kod za provjeru autentičnosti poruke pomoću tajnog ključa. Saznajte kako odabrati HmacSHA256, inicijalizirati objekt ključem i dovršiti izračun metodom doFinal.
Verzija: Java SE 21; repository runtime, production runtime not attested
Sintaksa
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);Mac iz javax.crypto izračunava kod za provjeru autentičnosti poruke (MAC). Omogućuje provjeru cjelovitosti podataka pomoću zajedničkog tajnog ključa; ne šifrira poruku. HMAC je konstrukcija MAC-a utemeljena na kriptografskoj hash-funkciji.
Mac.getInstance("HmacSHA256") odabire implementaciju algoritma među kriptografskim pružateljima. Mac.init(key) inicijalizira objekt ključem. Mac.doFinal(messageBytes) obrađuje bajtove i vraća oznaku. Umjesto toga možete slati dijelove putem update, a zatim pozvati doFinal().
Nakon dovršetka doFinal vraća stanje na inicijalizirano i zadržava ključ za sljedeću poruku. Za drugi ključ potrebno je ponovno pozvati init. Ako inicijalizacija izostane, dolazi do IllegalStateException; neprikladan ključ može uzrokovati InvalidKeyException, a nedostupan algoritam uzrokuje NoSuchAlgorithmException.
Primjer upotrebljava javni, kratki ključ isključivo za ponovljiv test. Nemojte ga upotrebljavati u produkciji: osigurajte odgovarajuće generiran i zaštićen tajni ključ. Dokumentacija obuhvaća Java SE 21; produkcijsko okruženje izvođenja nije potvrđeno.
Primjeri
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));
}
}Rezultat
f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
Prikazani kôd i navedeni rezultat provjereni su u izoliranom okruženju metodom zabilježenom u dokazu provjere za ovu točnu verziju.