JWT(JSON Web Token)とは

JWTとは、ログインした証明を持ち運べる形にした書類です。IETFのRFC 7519とOWASPの資料をもとに、署名と暗号化の違い、検証で確かめる項目、期限が切れるまで取り消しにくい性質を、初めての方にも分かる言葉で説明します。

執筆: 神崎 澪(セキュリティアナリスト(AI))監修: 千葉圭介更新日

JWTとは、ログインした証明を持ち運べる形にした書類です。JSON Web Tokenの略で、RFC 7519は、二者の間で主張(クレーム)をやり取りするための、コンパクトでURLにも載せられる表現と定めています。主張とは、「この利用者は誰か」「いつまで有効か」といった記載のことです。

JWTはどんな仕組み?

発行元の印鑑が押された証明書を想像してください。氏名や有効期限が書かれていて、受け取った側は、印鑑を確かめれば、内容が書き換えられていないと分かります。JWTも、記載と署名で成り立っています。

RFC 7519は、記載の守り方を二通り挙げています。署名つきの形式(JWS)は、記載にデジタル署名か認証コードを付けます。暗号化の形式(JWE)は、記載そのものを暗号化します。両方を使うときは、署名してから暗号化するのが通常の進め方とされています。

OpenID Connectでは、ログインの結果を伝えるIDトークンが、JWTの形をとります。実装の落とし穴は、JWTの実装不備に整理しました。

なぜJWTが大事なのですか?

手軽な反面、扱いを誤ると、偽造や取り違えを受け入れてしまいます。OWASPのREST Security Cheat Sheetは、JWTの検証で次の点を挙げています。

  • 署名のないJWTは受け取りません。署名か認証コードで、改ざんを検知します。
  • 検証に使うアルゴリズムは、JWTのヘッダーの記載ではなく、サーバー側の設定で決めます。
  • 発行元(iss)、宛先(aud)、有効期限(exp)を確かめます。
  • 失効が必要なときは、JWTのID(jti)を使った拒否リストを用意します。

もう一つの注意は、中身が見えることです。RFC 7519は、JWTにプライバシーに関わる情報が入る場合、漏れないよう対策を取ることを求めています。暗号化したJWTを使う、暗号化された通信で送る、そもそも載せない、といった方法です。

期限が切れるまで有効な点も、見落としがちです。OWASPは、JWTは期限まで有効なので、ログアウトなどの場面では、前述の拒否リストで失効させる方法があると述べています。

関連する言葉

  • アクセストークン:ログイン後に発行される、一時的な通行証のようなものです。
  • セッション:ログインしてから終えるまでの一連の利用状態です。
  • OpenID Connect:OAuth 2.0の上でログインの本人確認を行う仕組みです。
  • OAuth:パスワードを渡さずに、別のアプリへ許可を与える仕組みです。

次の一手

JWTの実装の落とし穴はJWTの実装不備にあります。自社のAPIやログインの入口は無料URLチェックで外から確かめられ、検証の設計は無料相談で相談できます。

よくある質問

JWTの中身は、他の人にも見えますか?

署名つきの形式は、改ざんを見つけるためのもので、中身を隠すものではありません。RFC 7519は、プライバシーに関わる情報が入る場合、暗号化したJWTを使うか、暗号化された通信で送ることを求めています。載せないことが、もっとも簡単な対策です。

JWTは、発行したあとにいつでも取り消せますか?

いつでも取り消せるわけではありません。OWASPは、JWTが期限まで有効であると述べています。ログアウトなどの場面で失効させたいときは、JWTのIDを使った拒否リストを用意する方法を挙げています。

よくある質問

JWTの中身は、他の人にも見えますか?

署名つきの形式は、改ざんを見つけるためのもので、中身を隠すものではありません。RFC 7519は、プライバシーに関わる情報が入る場合、暗号化したJWTを使うか、暗号化された通信で送ることを求めています。載せないことが、もっとも簡単な対策です。

JWTは、発行したあとにいつでも取り消せますか?

いつでも取り消せるわけではありません。OWASPは、JWTが期限まで有効であると述べています。ログアウトなどの場面で失効させたいときは、JWTのIDを使った拒否リストを用意する方法を挙げています。

外から見える穴を、今日のうちに確かめませんか

無料のURLチェックは数十秒で結果が出ます。費用の見当や進め方は、無料相談でご説明します。