Uso Básico

Este guia mostra as etapas fundamentais para usar a ferramenta JWT Parser na análise de JSON Web Tokens.

Etapa 1: Acesse a Ferramenta

Navegue até a ferramenta JWT Parser a partir da 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 fará o parse do 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 as funcionalidades da ferramenta

Etapa 3: Revise os Resultados do Parse

Depois de inserir um token JWT válido, você verá três seções principais:

Informações do Cabeçalho

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

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
• Observação 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 a sua área de transferência
3. Cole no seu editor de texto ou documentação de preferência

Limpar Conteúdo

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

Ver Histórico

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

Entendendo a Saída

Exemplo de Cabeçalho

{
  "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): O 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 Parse

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: Cabeçalho 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 somente em ambientes seguros e privados

Fluxo de Trabalho de Desenvolvimento

1. Gere tokens de teste no seu ambiente de desenvolvimento
2. Faça o parse deles 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 dos tokens de teste importantes
• Use o recurso de histórico para tokens analisados com frequência
• Limpe o histórico regularmente para preservar a privacidade

Próximos Passos

Agora que você entende o básico, explore os Recursos Avançados para aprender padrões de uso mais sofisticados e consulte as Considerações de Segurança para lidar com tokens com segurança.