База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / Java

Mac: удостоверяване на съобщения с HMAC

Класът javax.crypto.Mac изчислява код за удостоверяване на съобщение с помощта на таен ключ. Научете как да изберете HmacSHA256, да инициализирате обекта с ключ и да завършите изчислението с doFinal.

Версия: Java SE 21; repository runtime, production runtime not attested

Синтаксис

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

Mac от javax.crypto изчислява код за удостоверяване на съобщение (MAC). С него може да се проверява целостта на данните чрез споделен таен ключ; той не криптира съобщението. HMAC е конструкция MAC, базирана на криптографска хеш функция.

Mac.getInstance("HmacSHA256") избира реализация на алгоритъма от криптографските доставчици. Mac.init(key) инициализира обекта с ключ. Mac.doFinal(messageBytes) обработва байтовете и връща маркера. Като алтернатива подайте блокове чрез update, след което извикайте doFinal().

След завършване doFinal възстановява инициализираното състояние и запазва ключа за следващото съобщение. За друг ключ е необходимо отново да извикате init. Липсата на инициализация води до IllegalStateException; неподходящ ключ може да доведе до InvalidKeyException, а недостъпен алгоритъм води до NoSuchAlgorithmException.

Примерът използва публичен, кратък ключ единствено за повторяем тест. Не го използвайте в продукция: осигурете подходящо генериран и защитен таен ключ. Документацията се отнася за Java SE 21; продукционната среда за изпълнение не е потвърдена.

Примери

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

Резултат

f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници