Digite para filtrar os verbetes do Glossário.

    Redes e segurança · Vibe Coding: Do Zero ao MVP

    O que é JWT?

    O JWT transporta declarações entre sistemas em um token que pode ser assinado ou cifrado. Entenda como conferir o destinatário e a validade no recebimento.

    Também chamado de: JSON Web Token

    Declarações transportadas entre sistemas

    O JWT (JSON Web Token) é um formato compacto para transportar declarações entre sistemas. Cada declaração, chamada claim, associa um nome a um valor em um objeto JSON. O campo iss identifica o emissor e o campo aud indica o destinatário. A aplicação define quais declarações exige para aceitar o token.

    A RFC 7519 prevê declarações assinadas ou cifradas. Na representação compacta de um JWT assinado, três partes separadas por pontos carregam o cabeçalho, as declarações e a assinatura. As duas primeiras usam a codificação base64url, que permite recuperar o conteúdo sem conhecer a chave. Para manter essas declarações em sigilo, é necessário cifrar o conteúdo.

    Por que o destinatário precisa ser conferido

    Neste exemplo didático, o conteúdo decodificado de um token inclui "iss": "login.exemplo" e "aud": "relatorios". O serviço de relatórios reconhece esse emissor e espera esse destinatário. Ao receber o mesmo token, o serviço de cobrança deve recusá-lo porque o destinatário informado não corresponde ao serviço de cobrança, mesmo que a assinatura seja válida.

    Você consegue inspecionar esses campos com um decodificador, mas essa leitura ainda não confirma a autenticidade do token. O serviço precisa verificar a assinatura com uma chave confiável e aplicar as condições de aceitação. A RFC 8725 exige conferir o destinatário quando o emissor produz tokens para mais de uma aplicação.

    Algoritmo e prazo de validade

    O campo alg do cabeçalho informa um algoritmo, mas a aplicação deve aceitar somente os algoritmos permitidos por sua própria configuração. Confiar livremente no valor recebido permitiria ao remetente escolher como o serviço verifica o token.

    Quando presente, o campo exp estabelece um instante de expiração. O serviço deve recusar o token a partir desse instante, admitida uma pequena tolerância configurada para diferenças entre relógios. A verificação da assinatura e a conferência do prazo têm funções distintas: um token pode manter a assinatura correta depois de expirar.

    Dúvidas frequentes

    Perguntas frequentes sobre JWT

    O conteúdo de um JWT fica secreto?
    Um JWT apenas assinado mantém o conteúdo legível por qualquer aplicativo que receba o token. Para manter as declarações em sigilo, é necessário usar criptografia adequada, como a estrutura JWE (JSON Web Encryption) prevista pelo padrão.
    Uma assinatura válida autoriza qualquer ação?
    A assinatura confirma a integridade com a chave usada na verificação. O serviço também confere o emissor, o destinatário e os prazos exigidos pela aplicação. A permissão para executar uma ação depende do sistema de autorização.
    Como encerrar o acesso com um token ainda válido?
    O formato JWT não define um procedimento geral de revogação. A aplicação precisa estabelecer como recusar tokens anteriormente emitidos, por exemplo consultando uma lista de tokens revogados até o vencimento. Apagar o token no navegador não invalida outras cópias.

    Para continuar

    Recursos relacionados

    Aplicação na formação

    Vibe Coding: Do Zero ao MVP

    O JWT exige validação do emissor e da finalidade quando a aplicação o utiliza em autenticação ou autorização.

    Conhecer a formação
    Capa da Formação Vibe Coding do Zero ao MVP

    Fontes consultadas

    Referências deste verbete

    Este verbete ajudou você?

    Planos Promovaweb

    Tire seus projetos do papel

    O Plano Martech cobre automação e atendimento. O Plano IA Makers acrescenta desenvolvimento com IA, enquanto o Plano Founders trata de gestão de negócios. Todos são anuais.

    Plano Martech

    Para conectar automação, marketing e atendimento com infraestrutura própria.

    R$ 897

    R$ 597/ano

    • Grade de automação, atendimento, marketing e análise de indicadores
    • Instalador Exclusivo Promovaweb
    • n8n, Evolution API, Chatwoot e Mautic
    • Trilha DevOps incluída
    • Encontros ao vivo (terça e quinta)
    • Comunidade e acompanhamento
    Conhecer o plano

    Plano Founders

    Plano anual para fazer um projeto de tecnologia avançar, com 90 dias de mentoria intensiva. R$ 1.997 à vista ou até 10x de R$ 219 no cartão.

    R$ 1.997/ano

    • 12 meses de acesso ao Founders
    • 90 dias de mentoria intensiva, um encontro por dia útil
    • Dia de conteúdo (terça e quinta) e War Room (segunda, quarta e sexta)
    • Encontro semanal em grupo após a fase intensiva
    • Formação Vibe Coding incluída no plano anual
    • Consultoria individual de até duas horas (bônus)
    Conhecer o plano