Criptografia do conteúdo
O JWE (JSON Web Encryption) é um padrão para representar conteúdo cifrado com criptografia autenticada. O destinatário usa a chave adequada para recuperar o conteúdo e verificar sua integridade. A estrutura pertence à família de especificações JOSE (JSON Object Signing and Encryption).
A serialização compacta da RFC 7516 separa cinco partes em Base64url por pontos. O cabeçalho informa os algoritmos e o conteúdo cifrado ocupa a quarta parte. A última parte é a etiqueta de autenticação usada para detectar alterações.
O que o cabeçalho informa
O apêndice A.3 da RFC 7516 apresenta este cabeçalho para um exemplo de criptografia:
{"alg":"A128KW","enc":"A128CBC-HS256"}Neste cabeçalho, alg seleciona A128KW para cifrar a chave do conteúdo. O campo enc seleciona A128CBC-HS256 para a criptografia autenticada do conteúdo. O objeto mostra apenas o cabeçalho decodificado. Em um JWE completo, decodificar a primeira parte revela esses nomes e mantém o conteúdo cifrado.
Aceitação do token pela aplicação
Você precisa configurar os algoritmos permitidos pela integração. A biblioteca deve rejeitar combinações fora dessa configuração e validar a etiqueta de autenticação antes de disponibilizar o conteúdo. As recomendações da RFC 8725 também exigem a validação dos algoritmos nas estruturas cifradas usadas por JWTs.
Um JWT (JSON Web Token) pode carregar declarações em uma estrutura JWS (JSON Web Signature) ou JWE. A assinatura preserva a integridade sem necessariamente ocultar o conteúdo. Para um JWT cifrado, a decifragem ainda precisa ser acompanhada das verificações de emissor, destinatário e validade exigidas pela aplicação.
Dúvidas frequentes
Perguntas frequentes sobre JWE
- Todo JWT é um JWE?
- Um JWT pode usar uma estrutura assinada JWS ou uma estrutura cifrada JWE. Você precisa identificar o formato utilizado para saber quais validações aplicar.
- Decodificar Base64url revela o conteúdo cifrado?
- A decodificação recupera os bytes de cada parte. A leitura do conteúdo exige decifragem com a chave adequada e verificação da etiqueta de autenticação.
- Um JWE válido autoriza qualquer ação?
- A aplicação ainda precisa validar o conteúdo recebido. Para um JWT cifrado, isso inclui conferir o emissor e o destinatário esperado e aplicar as condições de validade do token.
Para continuar
Recursos relacionados
Documentação
RFC 7516: representação de conteúdo cifrado
Descreve a serialização compacta, os campos do cabeçalho e a verificação criptográfica do conteúdo.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar a validação de tokens e investigar falhas de uma integração com conteúdo cifrado.
Abrir recursoAplicação na formação
Formação DevOps
O uso de tokens cifrados exige revisar as chaves, os algoritmos permitidos e as validações aplicadas pela integração.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.