CKTIS / Java
Mac: uwierzytelnianie wiadomości za pomocą HMAC
Klasa javax.crypto.Mac oblicza kod uwierzytelniający wiadomość przy użyciu tajnego klucza. Poznaj wybór HmacSHA256, inicjalizację kluczem i zakończenie obliczeń przez doFinal.
Wersja: Java SE 21; repository runtime, production runtime not attested
Składnia
Mac mac = Mac.getInstance("HmacSHA256");
mac.init(key);
byte[] tag = mac.doFinal(messageBytes);Mac z pakietu javax.crypto oblicza kod uwierzytelniający wiadomość (MAC). Pozwala sprawdzać integralność danych przy użyciu wspólnego tajnego klucza; nie szyfruje wiadomości. HMAC jest odmianą MAC opartą na funkcji skrótu.
Mac.getInstance("HmacSHA256") wybiera implementację algorytmu spośród dostawców kryptograficznych. Mac.init(key) inicjalizuje obiekt kluczem. Mac.doFinal(messageBytes) przetwarza bajty i zwraca kod; alternatywnie można przekazywać fragmenty przez update, a następnie wywołać doFinal().
Po zakończeniu doFinal przywraca stan po inicjalizacji, zachowując klucz do następnej wiadomości. Inny klucz wymaga ponownego init. Brak inicjalizacji powoduje IllegalStateException; nieodpowiedni klucz może spowodować InvalidKeyException, a niedostępny algorytm — NoSuchAlgorithmException.
Przykład używa jawnego, krótkiego klucza wyłącznie dla powtarzalnego testu. Nie używaj go w produkcji: zapewnij odpowiednio wygenerowany i chroniony tajny klucz. Zakres dokumentacji to Java SE 21; środowisko produkcyjne nie zostało potwierdzone.
Przykłady
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));
}
}Wynik
f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8
Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.