Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

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.

Viri