Glossário

Key wrapping

Atualizado em · 4 min de leitura

Definição

Key wrapping é a técnica de criptografar uma chave criptográfica usando outra chave, chamada chave de encapsulamento (ou KEK), para que ela possa ser armazenada ou transmitida com segurança. No contexto fiscal, é usada para proteger chaves privadas de certificados digitais e segredos de integração, evitando que fiquem expostos em texto aberto.

Também conhecido como: Key wrapping, Encapsulamento de chave, Envelopamento de chave, Empacotamento de chave, Wrap de chave

O que significa key wrapping, em palavras simples?

Key wrapping pode ser traduzido como encapsulamento de chave. A ideia é guardar uma chave secreta dentro de um cofre que também é protegido por outra chave. Quem tem acesso ao cofre vê apenas um conteúdo embaralhado, inútil sem a chave que o abre.

Na criptografia, a chave que está sendo protegida costuma ser chamada de chave de dados (DEK, do inglês data encryption key), e a chave que a protege é a chave de encapsulamento (KEK, do inglês key encryption key). A KEK fica guardada em um local mais seguro e controlado, como um HSM ou um serviço de gerenciamento de chaves.

Como funciona o key wrapping?

Primeiro, o sistema gera ou recebe a chave que precisa ser protegida. Em seguida, aplica um algoritmo específico de encapsulamento, que usa a KEK para transformar essa chave em um bloco cifrado. Esse bloco pode então ser salvo em banco de dados, arquivo ou enviado pela rede sem expor o segredo original.

Quando a chave for necessária, o processo inverso, chamado unwrapping, usa a mesma KEK para recuperá-la. Algoritmos de encapsulamento, como o AES Key Wrap, também verificam a integridade: se o bloco cifrado tiver sido alterado, a recuperação falha, em vez de devolver uma chave corrompida.

Para que serve o key wrapping na emissão de documentos fiscais?

Para emitir NF-e, NFC-e, CT-e, MDF-e e, em muitos casos, NFS-e, o XML precisa ser assinado com a chave privada do certificado digital da empresa, geralmente um certificado A1 em arquivo PFX. Uma plataforma de emissão por API armazena esses certificados para assinar documentos automaticamente, o que exige protegê-los muito bem.

Com key wrapping, a chave usada para cifrar os certificados guardados não fica solta no banco de dados: ela própria é encapsulada por uma chave mestra mantida em ambiente protegido. Assim, mesmo que um backup ou uma tabela vaze, o invasor não consegue usar os certificados para emitir notas em nome da empresa.

Qual a diferença entre key wrapping e criptografia comum?

A criptografia comum protege dados em geral, como textos, arquivos ou registros. O key wrapping é um caso específico, voltado a proteger outras chaves, e usa algoritmos desenhados para esse tamanho de dado e com verificação de integridade embutida.

Os dois costumam trabalhar juntos em um modelo chamado criptografia de envelope: os dados são cifrados com uma chave de dados, e essa chave de dados é encapsulada com a KEK. Isso permite trocar a chave mestra sem precisar recriptografar todos os dados, apenas reencapsular as chaves de dados.

Onde o key wrapping aparece no dia a dia de uma integração?

Ele está presente em HSMs e serviços de gerenciamento de chaves na nuvem, que oferecem operações de wrap e unwrap sem que a chave mestra saia do equipamento. Também aparece no padrão JWE, usado para cifrar tokens e mensagens em JSON, que prevê algoritmos de encapsulamento da chave de conteúdo.

Para quem integra um ERP ou marketplace a uma API fiscal, o key wrapping costuma ser invisível: é responsabilidade da plataforma que guarda os certificados. Ainda assim, entender o conceito ajuda a avaliar se o fornecedor trata certificados e credenciais com o cuidado adequado.

Exemplos de Key wrapping

  • Uma plataforma de emissão fiscal recebe o arquivo PFX de um cliente, cifra o certificado com uma chave de dados e encapsula essa chave com uma chave mestra guardada em HSM antes de salvar no banco.
  • Um ERP que mantém certificados A1 de vários CNPJs usa um serviço de gerenciamento de chaves para fazer o wrap das chaves de cada empresa, separando o acesso por cliente.
  • Uma equipe de segurança faz a rotação anual da chave mestra e apenas reencapsula as chaves de dados existentes, sem precisar recriptografar todos os certificados armazenados.
  • Um sistema envia um token JWE em que a chave de conteúdo foi encapsulada com a chave pública do destinatário, garantindo que só ele consiga ler os dados.

Perguntas frequentes

Key wrapping é o mesmo que senha do certificado PFX?

Não. A senha do PFX protege o arquivo do certificado. O key wrapping é uma camada adicional usada por sistemas que armazenam chaves, cifrando-as com uma chave mestra mantida em ambiente seguro, como um HSM.

Preciso implementar key wrapping para usar uma API fiscal?

Normalmente não. Quem guarda e usa o certificado para assinar os documentos é a plataforma de emissão. Se o seu próprio sistema armazena certificados ou chaves, aí sim vale adotar a técnica ou um serviço de gerenciamento de chaves.

O que acontece se a chave de encapsulamento for perdida?

As chaves encapsuladas por ela ficam irrecuperáveis, e os dados protegidos também. Por isso a KEK deve ter backup seguro e controle de acesso rigoroso, geralmente dentro de um HSM ou serviço de gerenciamento de chaves.

Atualizado em · Como produzimos este glossário