Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

Mac: autenticar mensagens com HMAC

A classe javax.crypto.Mac calcula um código de autenticação de mensagem usando uma chave secreta. Saiba como selecionar HmacSHA256, inicializar o objeto com uma chave e terminar o cálculo com doFinal.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

Mac de javax.crypto calcula um código de autenticação de mensagem (MAC). Permite verificar a integridade dos dados usando uma chave secreta partilhada; não cifra a mensagem. HMAC é uma construção MAC baseada numa função de hash criptográfica.

Mac.getInstance("HmacSHA256") seleciona uma implementação do algoritmo entre os fornecedores criptográficos. Mac.init(key) inicializa o objeto com uma chave. Mac.doFinal(messageBytes) processa os bytes e devolve a etiqueta. Em alternativa, pode fornecer blocos através de update e, em seguida, chamar doFinal().

No final, doFinal repõe o estado inicializado e mantém a chave para a mensagem seguinte. Para usar outra chave, é necessário chamar init novamente. A falta de inicialização provoca IllegalStateException; uma chave inadequada pode provocar InvalidKeyException, e um algoritmo indisponível provoca NoSuchAlgorithmException.

O exemplo usa uma chave pública e curta apenas para um teste reproduzível. Não a utilize em produção: forneça uma chave secreta gerada e protegida de forma adequada. O âmbito da documentação é Java SE 21; o ambiente de execução de produção não foi atestado.

Exemplos

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

Resultado

f7bc83f430538424b13298e6aa6fb143ef4d59a14946175997479dbc2d1a3cd8

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes