CKTIS / Java
Mac: preverjanje pristnosti sporočil s HMAC
Razred javax.crypto.Mac izračuna kodo za preverjanje pristnosti sporočila s skrivnim ključem. Spoznajte izbiro HmacSHA256, inicializacijo objekta s ključem in zaključek izračuna z doFinal.
Različica: 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čuna kodo za preverjanje pristnosti sporočila (MAC). Omogoča preverjanje celovitosti podatkov s skupnim skrivnim ključem; sporočila ne šifrira. HMAC je konstrukcija MAC, ki temelji na kriptografski zgoščevalni funkciji.
Mac.getInstance("HmacSHA256") izbere implementacijo algoritma med kriptografskimi ponudniki. Mac.init(key) inicializira objekt s ključem. Mac.doFinal(messageBytes) obdela bajte in vrne oznako. Druga možnost je, da posredujete bloke prek update in nato pokličete doFinal().
Po koncu doFinal povrne inicializirano stanje in ohrani ključ za naslednje sporočilo. Za drug ključ je treba znova poklicati init. Če inicializacija manjka, pride do IllegalStateException; neustrezen ključ lahko povzroči InvalidKeyException, nedostopen algoritem pa povzroči NoSuchAlgorithmException.
Primer uporablja javni, kratek ključ izključno za ponovljiv preizkus. V produkciji ga ne uporabljajte: zagotovite ustrezno ustvarjen in zaščiten skrivni ključ. Dokumentacija zajema Java SE 21; produkcijsko izvajalno okolje ni bilo potrjeno.
Primeri
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
Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.