基本使用
本指南將引導您完成使用 JWT 解析器工具分析 JSON Web Token 的基本步驟。
步驟 1：開啟工具
從主工具頁面前往 JWT 解析器工具，或直接透過 URL /jwt-parser 進入。
步驟 2：輸入您的 JWT Token
方法 1：手動輸入
- 點擊「JWT Token」文字輸入區
- 貼上或輸入您的 JWT Token
- 工具會在您輸入時自動解析 Token
方法 2：載入範例
- 點擊「Load Example」按鈕
- 系統會自動載入一個範例 JWT Token
- 這對測試與熟悉工具功能很有幫助
步驟 3：查看解析結果
輸入有效的 JWT Token 後，您會看到三個主要區塊：
Header 資訊
- 演算法：使用的簽章演算法（例如 HS256、RS256）
- 類型：Token 類型（通常為「JWT」）
- 其他宣告：任何其他 Header 宣告
Payload 資料
- 標準宣告：iss、sub、aud、exp、nbf、iat、jti
- 自訂宣告：任何應用程式特定資料
- 到期時間：Token 何時到期（若有指定）
Signature
- 原始簽章：經過 base64url 編碼的簽章
- 驗證提醒：提醒您此工具不會驗證簽章
步驟 4：使用其他功能
複製結果
- 點擊「Copy Result」按鈕
- 解析後的資訊會複製到您的剪貼簿
- 貼到您偏好的文字編輯器或文件中
清除內容
- 點擊「Clear All」移除所有內容
- 以新的 Token 重新開始
查看歷史記錄
- 先前解析過的 Token 會顯示在歷史記錄區塊
- 點擊任一歷史項目即可重新載入該 Token
- 使用「Clear History」移除所有已儲存的 Token
理解輸出內容
Header 範例
{
"alg": "HS256",
"typ": "JWT"
}
Payload 範例
{
"sub": "1234567890",
"name": "John Doe",
"iat": 1516239022,
"exp": 1516242622
}
常見宣告說明
- sub（Subject）：Token 的主體
- iat（Issued At）：Token 的簽發時間
- exp（Expiration）：Token 的到期時間
- aud（Audience）：Token 的預期接收者
- iss（Issuer）：Token 的簽發者
錯誤處理
無效格式
如果您輸入了無效的 JWT 格式，會看到以下錯誤訊息：
- 「Invalid JWT format. JWT should have 3 parts separated by dots.」
解析錯誤
如果 Token 無法解析，您會看到：
- 「Failed to parse JWT token」
常見問題
- 缺少句點：JWT 必須剛好有 2 個句點來分隔 3 個部分
- 無效的 base64：每個部分都必須是有效的 base64url 編碼
- 格式錯誤的 JSON：Header 與 Payload 都必須是有效的 JSON
最佳實務
安全性
- 僅將此工具用於測試 Token 或您擁有的 Token
- 絕不要分享敏感的正式環境 Token
- 僅在安全且私密的環境中使用
開發流程
- 在您的開發環境中產生測試 Token
- 解析它們以驗證結構與宣告
- 使用結果除錯驗證問題
- 在切換專案時清除歷史記錄
Token 管理
- 保留重要測試 Token 的記錄
- 對經常分析的 Token 使用歷史記錄功能
- 定期清除歷史記錄以維護隱私