執筆: 神崎 澪(セキュリティアナリスト(AI))監修: 千葉圭介更新日
JWT(ジェイソン・ウェブ・トークン。ログイン中の利用者を示す署名付きの札)の実装不備とは、受け取る側が、署名、有効期限、発行元などの確認を省いたり甘くしたりしている状態です。アプリと連携するサイト、画面と裏側(API)を分けたサイト、他社サービスとログインを連携している会社が対象で、被害に遭うのは、そのサービスの利用者と運営者です。まずは、開発者や制作会社に「署名の検証を必須にして、受け付ける方式をサーバー側で決めていますか」と聞いてください。
問題になるのは、札の作り方よりも、受け取る側の確認の甘さです。仕組み、公表された事例、自分で確かめる方法、止める場所を順に説明します。攻撃の手順は書きません。
要注意:次に当てはまるサイトは確認を
一つでも当てはまるなら、札の確認が正しく作られているかを確かめる価値があります。
- スマートフォンアプリや、画面と裏側(API)を分けたサイトで、ログインを使っています。
- ログインにJWTを使うと聞いていますが、どの部品で確認しているかは知りません。
- 札の有効期限が数週間以上と長い、あるいは期限そのものを設けていません。
- ログアウトや退会のあとに、前の札で操作できるかを確かめたことがありません。
- 署名に使う鍵(秘密の文字列)が、短い、ソースコードに直書きされている、使い回されているのいずれかです。
- 札の中に、メールアドレスや電話番号などの個人情報を入れています。
- ログインを確認する部品(ライブラリ)を、導入してから一度も更新していません。
JWTの実装不備はどんな仕組みで起きるのですか?
JWTは、IETF(技術標準を決める団体)が2015年5月発行の RFC 7519 で定めた、「JSONという書式の主張の集まり」を運ぶ文字列です。入館証にたとえると、名前、有効期限、発行した受付の名前を書き、受付の印を押したものにあたります。札は3つの部分に分かれ、署名の方式などを書くヘッダー、「だれが・いつまで・どこ宛てか」を書く本文、そして印にあたる署名です。
署名があるのは、途中で書き換えられていないことを確かめるためです。ところが、受け取る側が署名を確かめない、確かめ方が甘い、期限や宛先を見ない、といった状態だと、書き換えられた札や、ほかのサービス向けの札が、本物として通ってしまいます。サーバーは、札を見せた人を、札に書かれたとおりの人として扱うからです。
図の五つの確認は、どれも、札を受け取るサーバー側の作り方と設定で決まります。止める場所は、サイトを作る側の手の内にあります。
札の中身は、隠されていません
署名は、書き換えを見つける仕組みで、中身を隠す仕組みではありません。OWASP(Webの安全性を高める非営利団体)は、署名付きのJWTは秘密にならず、保存領域やログから中身が見えると説明しています。中身を隠す必要があるときは、JWE(札を暗号化する方式)を使う方法が、OWASPの資料に載っています。
JWTの実装不備で起きる被害
公的な資料から読み取れる被害は、次のとおりです。
- 書き換えた札が、正しく署名された札として扱われ、ログイン後の機能を、ほかの利用者の立場で使われます(JVNの公表事例)。
- 期限が切れた札や、取り消したはずの札で、操作が続けられます。
- ほかのサービス向けに発行された札が、自分のサービスでも通ります(OWASPが発行元と宛先の検証を求める点にあたります)。
- 札に入れた個人情報が、ログや保存領域から読まれます。
公的資料での位置づけ
IETF は、2020年2月に RFC 8725(JWT のベスト・プラクティス。BCP 225)を発行しました。脅威には、弱い署名と署名検証の不足、弱い共通鍵、別の札との取り違えが並び、対策には、署名の方式の確認、発行元と宛先の検証が入っています。
MITRE の CWE(弱点の種類の番号)では、CWE-347「暗号の署名の不適切な検証」が当てはまります。製品が署名を検証しない、または誤って検証する、という内容です。
セッション管理・API認証との違い
名前の近い脆弱性との違いも押さえておきます。セッション管理の不備は、サーバーが覚えている番号が第三者に渡る穴です。JWTは、番号の代わりに署名付きの札を見せる方式で、札の確認の甘さも加わります。
API認証の不備は、認証の入口全体の穴で、JWTの扱いはその一部です。鍵がコードの中にあれば、ハードコードされた秘密情報の問題にもなります。
公的機関が公表した事例:JWTを扱う部品の署名検証の不備
JVN(JPCERT/CC と IPA が運営する、脆弱性の公表サイト)には、JWTを扱う部品(ライブラリ)の署名検証の不備が載っています。ここでは、2015年と2017年の3件を取り上げます。いまの版では直っていますが、部品の版を確かめる材料になります。
一件目は、2015年6月3日に公表された JVN#06120222 です。F21 が提供する JWT の、2.0 より前のバージョンに、トークンの署名を適切に検証しない脆弱性がありました(CVE-2015-2951)。JVNは、第三者によって細工されたデータを、正しく署名されたトークンとして扱ってしまう可能性があるとしています。CVSS の基本値は5.0で、対策は最新版への更新です。
二件目は、2015年6月25日に公表された JVN#25336719 です。namshi/jose の 2.2.1 以前、3.0.0 以前、4.0.0 以前、5.0.0 以前が対象です。同じくトークンの署名を適切に検証しない脆弱性で(CVE-2015-2964)、基本値は5.0、対策は最新版への更新です。
三件目は、2017年9月25日に公表された JVNVU#90916766 です。Scala 向けの実装 jwt-scala の 1.2.2 以前で、署名の検証を回避できる問題が見つかりました(CVE-2017-10862)。CVSS v3.0 の基本値は5.3です。対策は修正を含む最新のソースの利用で、回避策として、ヘッダーの署名方式の欄が適切な値かの確認も示されています。
三件に共通するのは、自社のコードが正しくても、使っている部品が確認を省けば穴が残ることです。基本値は高く見えませんが、署名された札として扱われる点が重く、当社は、ほかの利用者の立場で操作される入口になりうると見ています。対策の入口は、どの件でも更新でした。IPA の「安全なウェブサイトの運用管理に向けての20ヶ条」も、Webアプリケーションを構成するソフトウェアの脆弱性対策を、定期的に行うよう求めています。
自分のサイトはどう確かめればよいですか?
専門知識がなくても、次の順で確かめられます。確認は、自分が管理するサイトだけで行ってください。
- 使っている部品と版の一覧を出してもらいます。 JWTを扱う部品の名前、版、最後に更新した日を、開発会社に聞きます。名前が分かれば、JVN iPedia(IPA が運営する脆弱性対策情報のデータベース)で、公表済みの穴がないかを調べられます。
- 札の寿命を聞きます。 ログイン後に渡す札の有効期限が何分か、期限を必須にしているかを確かめます。
- 二つの端末で試します。 同じアカウントで、別の端末にもログインし、片方でパスワードを変えます。もう片方の操作がすぐ止まるか、期限まで続くかを見て、止まるまで最大何分かを開発会社に聞きます。
- 札の中身を見ます。 ブラウザの開発者ツールの「ネットワーク」の画面で、ログイン後の通信につく札を探し、不要な個人情報が入っていないかを見ます。札は合言葉と同じ扱いなので、外部の変換サイトやチャットには貼らないでください。
- 開発会社に質問します。 署名の検証は必須ですか。受け付ける方式は、サーバー側で決まっていますか。発行元と宛先の確認は、入っていますか。鍵の保管場所は、ソースコードの外ですか。
ここでの確認で分かるのは、確かめた範囲だけで、サイト全体の安全を保証するものではありません。迷う場合は、無料URLチェックで外から見える状態を確かめ、無料相談で、一緒に範囲を決めましょう。
JWTの実装不備への対策
対策は、サーバーを作る側(開発者)と、サイトを預かる側(運営者)で、やることが分かれます。
開発者向け
最優先は、署名の検証を自作せず、実績のある部品の検証機能に任せることです。そのうえで、次を確認します。
- 署名や暗号の操作が一つでも失敗した札は、札全体を断ります。RFC 8725 の3.3が、この扱いを求めています。
- 受け付ける署名の方式は、サーバー側の設定で固定します。札のヘッダーに書かれた方式を、そのまま信じてはいけません。RFC 8725 の3.1は、利用側が許可する方式の集まりを指定できること、鍵を一つの方式だけに結びつけることを求めています。
- 署名のない札は、ほかの手段で守られている場合を除き、部品に作らせも受け取らせもしません(RFC 8725 の3.2)。方式は、OWASPが推奨する HS256 系、ES256 系、PS256 系から選びます。
- 札が「この鍵で確かめてください」と指す鍵は、信用しません。OWASPは、ヘッダーが指す鍵の情報を、あらかじめ設定した信頼の起点につながる場合を除いて使わないよう求めています。
- 共通鍵方式の秘密は、160ビット以上の予測しにくさと、ハッシュの出力以上の長さ(HS256 なら256ビット)を持たせます(OWASP)。安全な乱数で作り、パスワードやコードへの直書きは避けます。
- 有効期限(exp)を必須にして、短めにします。発行元(iss)は文字列を完全に一致させ、鍵は確認した発行元のものだけから選びます。宛先(aud)には、自分のサービスの識別子が含まれることを求めます(RFC 8725 の3.8と3.9、OWASP)。
- 札の種類ごとに、検証の規則を分けます(RFC 8725 の3.11と3.12)。
- 取り消しが必要なら、OWASPが挙げる Token Status List、または札の識別子(jti)と発行元で引く取り消しリストを使います。札そのものやそのハッシュを引き鍵にしてはいけません。
- 札に入れる情報は、必要最小限にします。部品は、公表情報を見て更新します。
JWTを使うかどうかを先に考える作業も大切です。OWASPの資料には、使わない選択を考える節があります。画面と裏側が同じサーバーにある会員サイトなら、標準のサーバー側のセッションのほうが取り消しを任せやすいと、当社は見ています。セッション管理の不備の対策も参考にしてください。
サイト運営者向け
- 開発会社に、上の確認を依頼し、回答を文書でもらいます。JWTを使う窓口の一覧を添えてください。
- 部品の更新を、保守の作業に入れます。だれが公表情報を見るかも決めておきます。
- 署名の鍵は、ソースコードの管理や共有のチャットに載せません。入れ替えの手順も決めておきます。鍵を替えると、発行済みの札はすべて使えなくなり、利用者はログインし直します。
- 鍵が漏れた疑いがあるときは、緊急対応にご相談ください。
- 使っていない管理者アカウントを減らします(当社の対策メニュー /fix-menu の12番です)。
- ログインに2段階認証を付けても、札の確認の甘さは防げません。守れるのは、札を受け取る前の入口です。
自分でできる範囲と、専門家に頼む境目
自分でできるのは、前の節の確認と、開発会社への質問までです。
専門家に頼む目安は、次のいずれかに当てはまる場合です。
- JWTの検証を自作しているか、部品の設定を細かく変えているサイトです。
- 決済、会員情報、管理機能をAPIで提供している場合です。
- 外部サービスとのログイン連携があり、複数のサービスが同じ発行元を共有している場合です。
- ログイン後のAPIを、一度も診断したことがありません。
ログイン後の通信は外から見えないため、外から見える情報だけを確認する無料URLチェック(0円)では、札の扱いまでは分かりません。
費用の目安は、次のとおりです。API診断は98,000円〜(税別、〜10エンドポイント)です。Webアプリケーション診断のライトは98,000円〜(税別、〜10画面)、スタンダードは198,000円〜(税別、〜20画面、ログイン後の画面を含む手動確認)です。金額は、窓口や画面の数、ログイン後の範囲、緊急度で変わります。
脆弱性の個別修正は、1件10,000円〜(税別、内容により見積もり)です。診断には、修正後の再診断1回が含まれます。正式なお見積もりは、無料診断のあとにお出しします。
まず現状を知りたい方は、無料URLチェックをお使いください。判断に迷う場合は、無料相談で状況をうかがいます。
cyber-shield が確認すること
当社の API診断では、ツールの検査と担当者の確認を組み合わせて、次の点を調べます。範囲と方法は、診断同意書で先に合意し、その範囲だけを調べます。
- 署名の検証が、実際の通信で効いているか
- 受け付ける署名の方式が、サーバー側で固定されているか
- 有効期限が必須か、期限切れの札が断られるか
- 発行元と宛先の確認が、サービスごとに働いているか
- 札の中に、不要な個人情報や内部の情報が入っていないか
- 使っている部品の版と、公表済みの脆弱性との突き合わせ
- 鍵がソースコードに書かれていないか(ソースコード診断の範囲です)
結果は報告書にまとめ、修正後に再診断を1回行います。診断は、その時点の状態を確かめるもので、安全を保証するものではありません。
よくある質問
JWTとセッションIDは何が違いますか?
セッションIDは、サーバーが覚えている番号を見せてもらう方式です。JWTは、本人を示す情報と署名を札そのものに入れ、サーバーが署名と期限を確かめる方式です。取り消しや有効期限の扱いは、作る側が決めて実装する必要があります。
署名されていれば、札の中身は隠れていますか?
隠れていません。署名は、書き換えられていないことを確かめる印で、中身を読めなくする仕組みではありません。OWASPも、署名付きのJWTは秘密にならないと説明しています。個人情報は札に入れず、必要な場合は暗号化の方式(JWE)の利用を検討します。
有効期限は何分にすればよいですか?
OWASPは、札の再利用を抑える方法の一つとして短い有効期限を挙げていますが、具体的な長さは示していません。扱う情報の重さと、利用者が再ログインする手間を比べて、開発会社と決めてください。
ログアウトしたら、JWTはすぐ使えなくなりますか?
作りによります。サーバーが期限だけを見ている場合、ログアウトしても期限までは札が通ることがあります。OWASPは、取り消しの方法として、取り消し状況の一覧(Token Status List)や、札の識別子(jti)と発行元で引く取り消しリストを挙げています。止まるまでの時間は、開発会社に確認してください。
JWTの実装不備の確認にはいくらかかりますか?
ログイン後の通信は外から見えないため、無料URLチェック(0円)では確認できません。API診断は98,000円〜(税別、〜10エンドポイント)、Webアプリケーション診断のスタンダードは198,000円〜(税別、〜20画面、ログイン後の画面を含む手動確認)です。窓口や画面の数、ログイン後の範囲、緊急度で金額が変わります。
次の一手
今日できるのは、開発会社への三つの確認です。使っている部品の版、札の有効期限、ログアウト後に札が止まるまでの時間を聞いてください。
そのうえで、ログイン後のAPIで札が正しく確かめられているかを知りたい場合は、無料URLチェックで外から見える状態を確かめ、無料相談で診断の範囲を決めましょう。
よくある質問
JWTとセッションIDは何が違いますか?
セッションIDは、サーバーが覚えている番号を見せてもらう方式です。JWTは、本人を示す情報と署名を札そのものに入れ、サーバーが署名と期限を確かめる方式です。取り消しや有効期限の扱いは、作る側が決めて実装する必要があります。
署名されていれば、札の中身は隠れていますか?
隠れていません。署名は、書き換えられていないことを確かめる印で、中身を読めなくする仕組みではありません。OWASPも、署名付きのJWTは秘密にならないと説明しています。個人情報は札に入れず、必要な場合は暗号化の方式(JWE)の利用を検討します。
有効期限は何分にすればよいですか?
OWASPは、札の再利用を抑える方法の一つとして短い有効期限を挙げていますが、具体的な長さは示していません。扱う情報の重さと、利用者が再ログインする手間を比べて、開発会社と決めてください。
ログアウトしたら、JWTはすぐ使えなくなりますか?
作りによります。サーバーが期限だけを見ている場合、ログアウトしても期限までは札が通ることがあります。OWASPは、取り消しの方法として、取り消し状況の一覧(Token Status List)や、札の識別子(jti)と発行元で引く取り消しリストを挙げています。止まるまでの時間は、開発会社に確認してください。
JWTの実装不備の確認にはいくらかかりますか?
ログイン後の通信は外から見えないため、無料URLチェック(0円)では確認できません。API診断は98,000円〜(税別、〜10エンドポイント)、Webアプリケーション診断のスタンダードは198,000円〜(税別、〜20画面、ログイン後の画面を含む手動確認)です。窓口や画面の数、ログイン後の範囲、緊急度で金額が変わります。