JWT 解碼工具

解碼 JWT(JSON Web Token)。

使用範例

確認登入權杖中包含哪些資訊

想知道伺服器發出的 JWT 存取權杖裡有哪些宣告(使用者 ID、角色等)嗎?貼上後即可立即看到以易讀的 JSON 格式呈現的標頭與內容。

確認權杖何時到期

正在排查使用者一直被登出的問題嗎?exp 宣告會以易讀的日期與時間顯示,並以徽章標示是否已經過期。

確認簽章演算法

不確定權杖用的是 HS256 還是 RS256?標頭中的 alg 值會直接顯示在摘要區。

將解碼結果分享給團隊成員

想請同事看同一個權杖嗎?點擊「複製分享連結」即可複製一個包含目前權杖的連結,任何打開它的人都會立刻看到同一個權杖被解碼後的畫面。

檢查第三方 API 的 OAuth 存取權杖

OAuth 供應商給了你一個看起來不透明的存取權杖,但它其實是 JWT?貼進來,不必寫任何一行程式碼,就能看到範圍(scope)、受眾(aud)與發行者(iss)等宣告。

驗證自訂宣告確實加入了權杖

剛在權杖發行者中加入了像 "role": "admin" 或 "tenantId" 這樣的自訂宣告?請貼上剛發行的權杖,在圍繞它設計授權邏輯之前,確認該宣告確實存在且拼寫正確。

比較先後不久發行的兩個權杖

想弄清楚為什麼重新整理後的權杖行為與舊的不同?並排解碼兩者,並比較它們的內容,找出究竟是哪些宣告改變了。

在貼進錯誤回報前再次檢查權杖

正要把 JWT 貼到 GitHub issue 或 Slack 討論串?請先解碼,確認其中確切的內容,並在分享前清除任何敏感的宣告(如電子郵件或內部 ID)。

快速參考

Common JWT header segments

Base64URL標頭(Header)
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"HS256","typ":"JWT"}
eyJhbGciOiJIUzM4NCIsInR5cCI6IkpXVCJ9{"alg":"HS384","typ":"JWT"}
eyJhbGciOiJIUzUxMiIsInR5cCI6IkpXVCJ9{"alg":"HS512","typ":"JWT"}
eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"RS256","typ":"JWT"}
eyJhbGciOiJSUzUxMiIsInR5cCI6IkpXVCJ9{"alg":"RS512","typ":"JWT"}
eyJhbGciOiJFUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"ES256","typ":"JWT"}
eyJhbGciOiJQUzI1NiIsInR5cCI6IkpXVCJ9{"alg":"PS256","typ":"JWT"}
eyJhbGciOiJFZERTQSIsInR5cCI6IkpXVCJ9{"alg":"EdDSA","typ":"JWT"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9{"typ":"JWT","alg":"HS256"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzUxMiJ9{"typ":"JWT","alg":"HS512"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9{"typ":"JWT","alg":"RS256"}
eyJ0eXAiOiJKV1QiLCJhbGciOiJFUzI1NiJ9{"typ":"JWT","alg":"ES256"}

常見問題

這個工具會驗證簽章嗎?

不會。驗證簽章需要只有發行者才知道的密鑰(或公開金鑰),而把這個值輸入到任何網站都是安全風險。本工具只會解碼並顯示標頭與內容,絕不會檢查簽章是否有效。

分享連結中是怎麼帶上權杖的?

點擊「複製分享連結」會複製一個在網址後方加上 ?jwt=<權杖> 的連結,也就是說權杖本身會直接暴露在網址中。打開該連結會立即顯示這個權杖(取代原本儲存的內容),並以此值更新本機儲存空間。如果你透過聊天軟體或電子郵件分享連結,權杖可能會留在那些紀錄中,因此在分享以真實且有效的正式環境權杖產生的連結之前,請務必三思。

我貼上的權杖會傳送到伺服器嗎?

不會。所有解碼都完全在你的瀏覽器中進行,絕不會傳送到伺服器。為了讓你下次造訪時能接續先前的內容,你輸入的權杖只會儲存在瀏覽器的本機儲存空間(localStorage)中,不會在不同裝置或瀏覽器之間共用。清除輸入欄也會一併清除已儲存的內容。不過,仍建議避免把正式環境中使用的真實權杖貼到任意網站上。

exp、iat 和 nbf 是什麼?

這些是 JWT 中常見的標準宣告。iat 代表權杖的發行時間,exp 代表到期時間,nbf(「not before」)則代表在此時間之前權杖尚未生效。這些值都以 Unix 時間戳記(從 1970 年 1 月 1 日起算的秒數)儲存,本工具會將其轉換成易讀的日期格式顯示。

我看到格式無效的錯誤訊息。

JWT 必須恰好由句點(.)分隔成 3 個部分(標頭.內容.簽章)。請檢查是否混入了多餘的空白字元,或權杖是否被不完整地複製。

JWT 的內容(payload)有加密嗎?

沒有——這是關於 JWT 最常見的誤解之一。依據 RFC 7519,標頭與內容只是經過 base64url 編碼,並未加密。Base64url 是可還原的編碼,而不是密碼,因此任何取得權杖的人,都能在不需要任何密鑰或金鑰的情況下,解碼並讀取其中的每一項宣告(claim)——這正是本工具所做的事。簽章的存在,是讓發行者能驗證權杖沒有被竄改,且確實來自他們;它並不會隱藏內容的資料。如果權杖帶有敏感資料,請將它視為可讀的明文,絕不要將真正機密的資訊(密碼、完整信用卡號等)放進宣告中。

「base64url」究竟是什麼意思?與一般的 base64 有什麼不同?

Base64url 的概念與標準 base64 相同——將任意位元組編碼為文字——但它替換了兩個不適合用於 URL 的字元:+ 變成 -、/ 變成 _,而結尾的 = 填充通常會省略。JWT 對標頭與內容使用 base64url,正是因為產生的權杖需要能夠安全地在 URL、HTTP 標頭與 Cookie 中傳遞,而不需要額外的跳脫。

有人能利用這個工具顯示的內容偽造權杖嗎?

看到解碼後的標頭與內容,並不會讓你有能力偽造有效的權杖。要產生伺服器會接受的權杖,你需要以發行者的密鑰(HS256 類演算法)或私密金鑰(RS256/ES256 類演算法)重新簽署——這是本工具從不要求,也無法取得的資訊。手動編輯解碼後的 JSON 並重新編碼,會改變內容但使簽章失效,因此正確實作的伺服器會拒絕它。

為什麼簽章區段看起來是亂碼,而不是 JSON?

與標頭和內容不同,簽章不是被編碼的 JSON——它是以標頭中指定的演算法(例如 HMAC-SHA256 或 RSA-SHA256)對標頭與內容簽署後,所產生的原始密碼學輸出。這就是為什麼進一步解碼並不會產生可讀的文字;本工具只是將它顯示為它本來就是的 base64url 字串。