Uso Básico

Este guia apresenta as etapas fundamentais para usar a ferramenta JWT Parser e analisar JSON Web Tokens.

Etapa 1: Acesse a Ferramenta

Navegue até a ferramenta JWT Parser pela página principal de ferramentas ou acesse diretamente pela URL /jwt-parser.

Etapa 2: Insira Seu Token JWT

Método 1: Entrada Manual

1. Clique na área de texto "JWT Token"
2. Cole ou digite seu token JWT
3. A ferramenta analisará o token automaticamente enquanto você digita

Método 2: Carregar Exemplo

1. Clique no botão "Load Example"
2. Um token JWT de exemplo será carregado automaticamente
3. Isso é útil para testar e aprender a funcionalidade da ferramenta

Etapa 3: Revise os Resultados Analisados

Depois que um token JWT válido for inserido, você verá três seções principais:

Informações do Header

• Algoritmo: O algoritmo de assinatura usado (por exemplo, HS256, RS256)
• Tipo: Tipo do token (normalmente "JWT")
• Claims Adicionais: Quaisquer outros claims do header

Dados do Payload

• Claims Padrão: iss, sub, aud, exp, nbf, iat, jti
• Claims Personalizados: Quaisquer dados específicos da aplicação
• Expiração: Quando o token expira (se especificado)

Assinatura

• Assinatura Bruta: A assinatura codificada em base64url
• Nota de Verificação: Lembrete de que esta ferramenta não valida assinaturas

Etapa 4: Use Recursos Adicionais

Copiar Resultados

1. Clique no botão "Copy Result"
2. As informações analisadas serão copiadas para sua área de transferência
3. Cole em seu editor de texto ou documentação preferidos

Limpar Conteúdo

1. Clique em "Clear All" para remover todo o conteúdo
2. Comece novamente com um novo token

Ver Histórico

• Tokens analisados anteriormente aparecem na seção de histórico
• Clique em qualquer item do histórico para recarregar esse token
• Use "Clear History" para remover todos os tokens armazenados

Entendendo a Saída

Exemplo de Header

{
  "alg": "HS256",
  "typ": "JWT"
}

Exemplo de Payload

{
  "sub": "1234567890",
  "name": "John Doe",
  "iat": 1516239022,
  "exp": 1516242622
}

Explicação de Claims Comuns

• sub (Subject): O assunto do token
• iat (Issued At): Quando o token foi emitido
• exp (Expiration): Quando o token expira
• aud (Audience): Destinatário pretendido do token
• iss (Issuer): Quem emitiu o token

Tratamento de Erros

Formato Inválido

Se você inserir um formato JWT inválido, verá a seguinte mensagem de erro:

• "Invalid JWT format. JWT should have 3 parts separated by dots."

Erros de Parsing

Se o token não puder ser analisado, você verá:

• "Failed to parse JWT token"

Problemas Comuns

• Pontos ausentes: O JWT deve ter exatamente 2 pontos separando 3 partes
• base64 inválido: Cada parte deve ser uma codificação base64url válida
• JSON malformado: Header e payload devem ser JSON válidos

Boas Práticas

Segurança

• Use esta ferramenta apenas com tokens de teste ou tokens que pertencem a você
• Nunca compartilhe tokens sensíveis de produção
• Use apenas em ambientes seguros e privados

Fluxo de Trabalho de Desenvolvimento

1. Gere tokens de teste no seu ambiente de desenvolvimento
2. Analise-os para verificar a estrutura e os claims
3. Use os resultados para depurar problemas de autenticação
4. Limpe o histórico ao alternar entre projetos

Gerenciamento de Tokens

• Mantenha um registro de tokens de teste importantes
• Use o recurso de histórico para tokens analisados com frequência
• Limpe o histórico regularmente para manter a privacidade

Próximos Passos

Agora que você entende o básico, explore Recursos Avançados para aprender padrões de uso mais sofisticados e consulte Considerações de Segurança para um manuseio seguro de tokens.