O que é um SD-JWT?

O SD-JWT (Selective Disclosure for JSON Web Tokens) é um token assinado em que algumas declarações ficam ocultas. O emissor assina apenas hashes com salt dessas declarações, chamados de resumos criptográficos. O titular então decide quais declarações revelar, enviando as respectivas divulgações junto com o token. Um verificador vê as declarações que o titular escolheu, pode conferir se cada uma corresponde a um resumo criptográfico assinado pelo emissor e não fica sabendo nada sobre as demais.

O SD-JWT VC cria credenciais verificáveis com base nele: um tipo vct indica de que credencial se trata, e uma chave cnf vincula a credencial ao dispositivo do titular. É um dos dois formatos de credencial das Carteiras Europeias de Identidade Digital, que todos os países da UE devem oferecer aos seus cidadãos até dezembro de 2026, e o OpenID for Verifiable Credentials também o utiliza.

Como é um SD-JWT

Um SD-JWT é uma string formada por partes separadas pelo caractere til (~):

  • O JWT assinado pelo emissor, header.payload.signature.
  • Uma divulgação para cada declaração revelada, cada uma composta por uma matriz JSON codificada em Base64url com um salt aleatório, o nome da declaração e o seu valor. As divulgações de elementos de matriz não incluem o nome.
  • Um JWT de vinculação de chave opcional no final, que o titular assina para mostrar que a apresentação é dele e se destina a este verificador. Sem ele, a string termina com um til.

Como usar

Cole o SD-JWT. Quebras de linha e espaços são ignorados, então um token quebrado em várias linhas e copiado de um log também funciona.

Para verificar a assinatura do emissor, insira a chave pública do emissor como uma JWK, um conjunto de JWKs (é usada a chave com o kid do token), uma chave pública PEM ou um certificado X.509. Uma JWK privada colada também funciona; apenas a parte pública dela é usada. Quando o campo da chave está vazio, é usado o certificado do x5c do cabeçalho do token, se houver.

O que você vê

  • Verificações da assinatura, das divulgações, da vinculação de chave, do período de validade e do algoritmo de hash.
  • Cabeçalho do JWT do emissor, com o algoritmo, o tipo (dc+sd-jwt para SD-JWT VC) e o ID da chave.
  • Payload assinado, com os resumos criptográficos (_sd) das declarações ocultas e marcadores {"...": digest} para os elementos de matriz ocultos.
  • Declarações com divulgações, o payload com cada divulgação colocada no seu lugar, como um verificador o leria.
  • Divulgações, uma tabela com a declaração, o valor, a posição nas declarações e o resumo criptográfico de cada divulgação.
  • JWT de vinculação de chave, com o cabeçalho e o payload, incluindo o destinatário (aud), o nonce e o sd_hash.

O que as verificações significam

  • Assinatura: o JWT do emissor foi assinado pela chave que você inseriu. Quando a ferramenta recorre ao certificado do cabeçalho, ela mostra que o token corresponde ao seu próprio certificado. Se esse certificado pertence a um emissor confiável, por exemplo um que esteja nas listas de confiança da UE, é algo que esta verificação não abrange.
  • Divulgações: o resumo criptográfico de cada divulgação aparece exatamente uma vez no token assinado. Uma divulgação alterada tem um resumo diferente e, por isso, deixa de corresponder, e uma divulgação enviada duas vezes é sinalizada.
  • Vinculação de chave: o sd_hash do JWT de vinculação de chave é o hash desta apresentação exata (o SD-JWT até o último til), e esse JWT foi assinado pela chave do cnf da credencial. Remover ou adicionar uma divulgação invalida o hash.
  • Período de validade: os horários de expiração (exp) e de início (nbf) do token, comparados com o relógio do seu dispositivo.
  • Algoritmo de hash: os resumos criptográficos usam o algoritmo indicado em _sd_alg, ou SHA-256 quando o token não indica nenhum. Os navegadores conseguem calcular SHA-256, SHA-384 e SHA-512.

Privacidade

A decodificação e todas as verificações são feitas no seu navegador, então o token e as chaves não são enviados para lugar nenhum. Credenciais reais contêm dados pessoais, então use credenciais de teste ao compartilhar capturas de tela.