Glossário · Programação e APIs

O que é JWT?

JWT: JSON Web Token

Definição

JSON Web Token: formato compacto para transportar declarações (claims) entre sistemas, assinado digitalmente e, opcionalmente, cifrado. Muito usado como token de acesso em APIs.

Como funciona

Um JWT assinado (RFC 7519) tem três partes em base64url separadas por pontos: o cabeçalho (algoritmo e tipo), o conteúdo (claims como sub, exp e iss) e a assinatura. A assinatura segue o JWS (RFC 7515), com HMAC ou chave pública (RSA, ECDSA).

Assinado não é cifrado: quem tem o token lê o conteúdo só decodificando o base64url. Não coloque senhas nem dados sensíveis num JWT comum.

Quem recebe o token deve verificar a assinatura com o algoritmo esperado, a validade (exp, nbf), o emissor (iss) e o público (aud). O RFC 8725 reúne as boas práticas, como nunca aceitar o algoritmo none.

Na prática

Cabeçalho e conteúdo decodificados de um JWT fictício:

JWT decodificado
cabeçalho: {"alg":"ES256","typ":"JWT"}
conteúdo:  {"sub":"ramal-2001","iss":"https://auth.example.com","aud":"api-pbx","exp":1792500000}

Erro comum

Emitir JWTs de longa duração sem forma de revogação. Um token assinado vale até o exp, mesmo que o usuário saia da empresa; use validade curta e tokens de renovação.

Termos relacionados

Referências

Padrões e documentação

Veja também o glossário completo, o blog e os cursos da EDCA.

Cursos

Aprenda VoIP e redes com a EDCA.

Cursos sobre SIP, Wireshark e cálculo de sub-redes IPv4.

Ver os cursos

Newsletter

Receba novos artigos e termos.

Um e-mail quando houver conteúdo novo. Sem spam, e você sai quando quiser.

Assinar a newsletter