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

CKTIS / Java

SecretKeySpec — uma chave a partir de um array de bytes

SecretKeySpec envolve bytes de chave existentes e o nome de um algoritmo. Copia os dados, mas não verifica a sua validade criptográfica.

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

Sintaxe

new SecretKeySpec(byte[] key, String algorithm)
new SecretKeySpec(byte[] key, int offset, int len, String algorithm)

javax.crypto.spec.SecretKeySpec implementa SecretKey e KeySpec, independentemente de um fornecedor. Envolve bytes em bruto; não gera uma chave nem a deriva de uma palavra-passe.

O construtor copia o array inteiro ou len bytes a partir de offset. Não valida a chave para o algoritmo. A versão com dois argumentos rejeita null e um array vazio com IllegalArgumentException.

getAlgorithm() devolve o nome do algoritmo, getFormat() devolve RAW e getEncoded() devolve uma nova cópia dos bytes. Copiar não significa encriptar nem armazenar de forma segura.

O exemplo demonstra ambas as cópias defensivas. Os bytes fixos destinam-se apenas à demonstração; não os utilizes como chave em produção.

Exemplos

import javax.crypto.spec.SecretKeySpec;

public class Main {
    public static void main(String[] args) {
        byte[] bytes = new byte[16];
        bytes[0] = 7;
        SecretKeySpec key = new SecretKeySpec(bytes, "AES");
        bytes[0] = 9;
        byte[] exported = key.getEncoded();
        exported[0] = 11;
        System.out.println(key.getAlgorithm());
        System.out.println(key.getFormat());
        System.out.println(key.getEncoded()[0]);
    }
}

Resultado

AES
RAW
7

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