---
title: JWT クレーム設計ケーススタディ ― 共通の基準・重点・見送りを、攻撃と除去実験で測る
tags:  #jwt #oauth #aiエージェント #認証認可 #マイクロサービス  
author: [日下 武紀](https://docswell.com/user/takenori_kusaka)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/G7W135KQJ2.jpg?width=480
description: 「JWT クレーム設計ガイド」の対になる実測のケーススタディです（49 枚、ノート欄に詳しい解説つき）。銀の弾丸はないという前提で、どの組織でも外せない「共通の基準」（9 要素）、題材ごとの「重点」、意図した「見送り」を決め、その効果を測りました。  ・題材：マルチテナント SaaS／社内業務システム（複数 IdP）／AI エージェントの委任 ・測り方：67 ケース（攻撃 54・正規の要求 13）を、素朴（N）・基準（B）・基準＋重点（BE）の 3 構成で実行し、要素を 1 つずつ外す除去実験で、どの要素がどの攻撃を止めているかを確かめる ・主な結果：共通の基準だけでは AI エージェントへの攻撃は 1 件も止まらず、重点を足すと 0 件。厳しい基準は正規の要求を 2 件誤拒否し、IdP ごとの扱い（入口での正規化・groups 超過の解決）で解消。契約テストは文字列の中の形式の変化などを見逃す ・Keycloak 26.8 と PostgreSQL 16（RLS）は実機。Entra ID・Okta・Cognito・Auth0 は公式文書の形を再現した模擬。送信者制約（DPoP）は推奨だが効果は未検証 ・付録：JWT クレーム一覧（805 行、題材ごとの採否・理由・代替・見直し条件つきの xlsx）  ガイド（152 枚）: https://www.docswell.com/s/takenori_kusaka/ZWR7NJ-jwt-claims-guide Web 版・実験コード・結果・一覧表・ファクトチェックの記録: https://github.com/Takenori-Kusaka/jwt-claims-casestudy  本資料は生成AI（Claude）を使って作成し、筆者が確認して公開しています。
published: November 18, 26
canonical: https://docswell.com/s/takenori_kusaka/KJWMVQ-jwt-claims-casestudy
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/G7W135KQJ2.jpg)

JWT
CLAIM DESIGN CASE STUDY
JWT クレーム設計ケーススタディ
銀の弾丸はない。共通の基準・題材ごとの重点・意図した見送りを、攻撃と除去実験で測る
共通の基準
＋ 重点
＋ 見送り
9 要素（全題材で同じ）
題材ごとに 4〜5 要素
失うことと見直し条件を書いて残す
対象：「JWT クレーム設計ガイド」を読んだ（これから読む）新任のテックリーダー
実機：Keycloak 26.8.0・Postgres 16（RLS）／模擬：Entra ID・Okta・Cognito・Auth0（2026-11 の公式文書の形）／67 ケース


# Page. 2

![Page Image](https://bcdn.docswell.com/page/4JZPVNZ373.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
この資料の位置づけ：ガイドは原則、ケーススタディは判断の数字
ガイド（152 枚）で示した原則のうち、どれを必須にし、何を見送るかを、測った数字で示す
ガイド（前提編）
ケーススタディ（本資料）
付録の一覧表（xlsx）
• 原則・仕様・IdP の実際
• 67 ケース（攻撃＋正規の要求）
• 805 行のクレーム
• 仕様・公的な指針・書籍が根拠
• 素朴・基準・基準＋重点と除去実験
• 題材 A・B・C ごとの判定と理由
• 152 枚（Web 版あり）
• Keycloak の実機の測定・試算
• 見直し条件と検証 ID
凡例
題材 B
結果 results/・catalog/ の結果のファイル（節）
右上の表示：前提・構成・汎用・題材 A〜C・測定・判断のどこの話か
実装 cs/・kc/・catalog/scripts の実装
ガイド ガイドの該当 Part
スライド下の行：そのスライドの根拠（3 種類）。本文は要点、ノート欄は詳しい説明
結果 README.md（冒頭・付録）
実装 run_all.py（全題材と測定を 1 本で実行）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 12 S149（重点と見送り）・S7（用語）
2


# Page. 3

![Page Image](https://bcdn.docswell.com/page/YE6M58ZZJV.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
結論：基準では攻撃が残る。重点で、見送りの 1 件まで減る
基準（B）では題材 A 5 件・題材 B 7 件・題材 C 12 件が通る。基準＋重点（BE）では見送りの 1 件だけ
題材
攻撃
素朴（N）
通った
基準（B）
通った
基準＋重点
（BE）通った
素朴（N）
誤処理
基準（B）
誤処理
汎用の攻撃（Part 1）
14
13
0
—
1
0
0
—
題材 A マルチテナント SaaS
10
9
5
0
4
1
1
0
題材 B 社内業務システム
18
18
7
1
5
0
2
0
題材 C AI エージェントの委任
12
12
12
0
3
0
0
0
正規
基準＋重点
（BE）誤処理
リーダーの視点
基準は全題材で同じ、重点は題材で選ぶ。題材 B の残り 1 件（盗まれたトークンの再送 B23）は、見直し条件を付けた意図的な見送り
誤処理＝正規の要求が拒否された、または他テナントの行が混ざった（A4）。「—」は汎用の攻撃に重点が無いため
結果 results/summary.md §攻撃が通った数と、正規の要求が
正しく処理されなかった数／results/scores.json
実装 cs/flags.py（N・B・BE の定義）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 1・4（基準）、Part 5〜10（重点）
3


# Page. 4

![Page Image](https://bcdn.docswell.com/page/GE5ZY9W974.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
測り方：構成を要素の集合にし、1 つずつ外して何が再び通るかを見る
素朴（N）・基準（B）・基準＋重点（BE）を比べ、除去実験で各要素が何を防ぐかを確かめる。誤拒否も数える
素朴（N）
基準（B）
基準＋重点（BE）
要素なし（よくある誤り）
共通の基準 9 要素
基準 ＋ 題材の重点
除去実験
• 基準（B）から要素を 1 つ外す（9 通り）
• 基準＋重点（BE）から重点を 1 つ外す（題材 A 4・題
材 B 4・題材 C 5 通り）
決定的
仮想の時計
乱数の種を固定
• LLM を使わない。何度流
しても同じ判定
• 期限切れ・取り消し後の
時刻を進める
• 寿命の試算は seed
20261117
• 題材 A は接続プールの 3 構成を追加
注意
正規の要求が拒否されるのも失敗（誤拒否）。攻撃だけを数えると、厳しすぎる基準の副作用を見逃す
結果 README.md §構成と要素
実装 cs/flags.py configs()／cs/jwtlib.py（仮想の時計）／
cs/lifetime.py（seed=20261117）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 1・4〜10（各要素の根拠）
4


# Page. 5

![Page Image](https://bcdn.docswell.com/page/972RG2Q5ER.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
環境：Keycloak と Postgres は実機、商用 IdP は模擬
実機は OSS の 2 つだけ。Entra ID・Okta・Cognito・Auth0 は 2026-11 の公式文書の形の模擬
対象
扱い
使った題材
Keycloak 26.8.0
実機（コンテナ）。レルム t1・t2・corp
題材 A・B・C、Keycloak
の測定
Postgres 16（alpine）
実機（コンテナ）。行単位の制御（RLS）
題材 A
• Keycloak の起動 32 秒
題材 B
• メモリ：Keycloak 773.7 MiB・Postgres
30.81 MiB
測定の環境
• AMD Ryzen 7 3700X・Windows 11
• Python 3.14.6・PyJWT 2.10.1
Entra ID・Okta・Cognito・
Auth0
模擬（2026-11 の公式文書の形）
内部のトークン発行サービス
模擬（仮想の時計で時刻を進める）
• 全体の実行 157 秒
題材 B の内部トークン、題
材C
注意
模擬の IdP は実際のサービスの挙動のすべてではない。「各社の製品で測った」とは言えない
結果 results/measurements.json §env／README.md
§注意
実装 run_all.py／cs/infra.py／kc/import/t1.json・t2.json
・corp.json
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（IdP の実際）
5


# Page. 6

![Page Image](https://bcdn.docswell.com/page/DJYDVYW6JM.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材：67 ケース＝攻撃 54 件＋正規の要求 13 件
件数は攻撃と正規の要求の合計。「通った」は攻撃の数、「誤拒否・誤処理」は正規の要求の数で数える
汎用の攻撃 15 件
題材 A マルチテナント
SaaS 14 件
題材 B 社内業務システム
23 件
題材 C AI エージェントの委
任 15 件
攻撃 14・正規 1
攻撃 10・正規 4
攻撃 18・正規 5
攻撃 12・正規 3
• alg none・HS256・kid・jku
・jwk
• テナントの出どころ・BOLA
• ID トークン・宛先・ヘッダーの
偽装
• パススルー・代理の混乱
• groups 超過・異動・ログアウ
ト
• 取り消し・深さ・範囲の拡大
• exp・aud・iss・typ
• 接続プール・他テナントのマッ
パー
• 必須の欠落・型の揺れ
• 連携先の鍵・軽量 AT
• act の読み違い・承認の照合
• IdP ごとの癖・盗まれたトーク
ン
ポイント
合計 67 件＝攻撃 54 件＋正規の要求 13 件。題材 A の誤処理には、正規の集計が他テナントの行を返した誤り（A4）を含む
結果 results/matrix.json／results/scores.json（attacks・
legit）／README.md §題材
実装 cs/generic.py・scen_a.py・scen_b.py・scen_c.py の
cases()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 1・3・5〜10
6


# Page. 7

![Page Image](https://bcdn.docswell.com/page/V7N6MPP178.jpg)

CHAPTER 1
共通の基準：9 要素と汎用
の攻撃
この章で答えられるようになる問い
• 9 つの要素は、それぞれ何を確かめるか
• 汎用の攻撃は、基準でいくつ止まるか
• 1 つ外すと、何が再び通るか
• 汎用の攻撃だけでは価値が見えない要素はどれか
受け入れの検証と、組織のクレームの読み方。どの題材でも
外せない最大公約数
7


# Page. 8

![Page Image](https://bcdn.docswell.com/page/YJ9LN33YE3.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
共通の基準 9 要素：受け入れの確認 5 つと読み方 4 つ
共通の検証部品に入れられる。検証の時間は p50 82.3 µs（素朴）と 84.2 µs（基準）
要素
中身
ガイド
alg
alg の許可リスト（RS256）。jku・jwk・x5u・x5c を無視し、kid は登録済みの鍵だけ
Part 1
iss
iss を許可リストと完全一致。鍵はその発行者に登録されたものだけ（Storm-0558 の教訓）
Part 1・5
aud
aud に自分が含まれるか
Part 1
exp
exp を必須にし、ずれは 30 秒まで
Part 1
typ
typ（Cognito は token_use）でアクセストークンだけを受ける
Part 1
required
組織で必須と定めたクレームが無ければ拒否（fail closed）
Part 4
types
必須クレームの型を確認（ID は文字列、配列は配列）
Part 4
immutable_id
利用者のキーは sub・oid+tid・uid。ログイン名やメールを使わない
Part 4
namespace
組織のクレームは https://claims.example.com/ の中だけを読む
Part 4
受け入れの確認 alg・iss・aud・exp・typ
結果 results/summary.md §要素・§時間／
results/measurements.json perf
組織のクレームの読み方 required・types・immutable_id・namespace
実装 cs/flags.py BASE／cs/verify.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 1（検証の順序）・Part 4（設計原則）・Part 5
8


# Page. 9

![Page Image](https://bcdn.docswell.com/page/GJ8XKMMK7D.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
汎用の攻撃：素朴な検証では 14 件中 13 件が通り、基準では 0 件
右端は、基準（B）から外すとその攻撃が再び通る要素。G14（数値の sub）は素朴（N）でも拒否された
ID
内容
素朴（N）
基準（B）
G0
正規：発行者が署名した正しいトークン
受理
受理
—
G1
alg を none にして署名なしで送る
通る
拒否
alg
G2
RS256 を HS256 に変え、公開鍵を HMAC の秘密にする
通る
拒否
alg
G3
kid にパスを入れ、空の鍵と空の秘密で署名する
通る
拒否
alg
G4
jku で攻撃者の鍵の場所を指す
通る
拒否
alg
G5
ヘッダーに自分の公開鍵（jwk）を埋め込む
通る
拒否
alg
G6
exp の無いトークン
通る
拒否
exp
G7
1 日前に期限が切れたトークン
通る
拒否
exp
G8
別のサービス（invoices）宛てのトークンを orders に送る
通る
拒否
aud
G9
同じ鍵の集合に載る別の発行者が、自分の iss で発行
通る
拒否
iss
G10
別の発行者の鍵で iss を偽って署名（Storm-0558 の型）
通る
拒否
alg・iss（どちらでも）
G11
同じ発行者の ID トークン（typ JWT）を API に送る
通る
拒否
typ
G12
テナントのクレームが無いトークンを既定のテナントで処理
通る
拒否
required
G13
テナントのクレームが配列（2 テナント分）
通る
拒否
types
G14
sub が数値
拒否
拒否
重ねて防御（PyJWT 2.10）
結果 results/summary.md §汎用の攻撃・§除去実験：B から
1 つ外すと
実装 cs/generic.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
外すと再び通る要素
ガイド ガイド はじめに S5（事故の例：Storm-0558）・Part 1（危
険なヘッダー・検証の順序）・Part 4（型）
9


# Page. 10

![Page Image](https://bcdn.docswell.com/page/LJL8Z33PER.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
除去実験：汎用の攻撃だけでは、9 要素のうち 2 つの価値が見えない
immutable_id を外すと B13、namespace を外すと A5 が通り、正規の B21 が拒否される
基準（B）から外した要素
汎用
題材 A
題材 B
題材 C
alg
G1〜G5、G10
—
—
—
iss
G9、G10
—
B10
—
aud
G8
—
B3（正規の B16 は通るように）
—
exp
G6、G7
A14
—
—
typ
G11
—
—
—
required
G12
—
B8、B15（正規の B9 は通るように）
—
types
G13
A12
B22
—
immutable_id
—
—
B13
—
namespace
—
A5
正規の B21 を誤拒否
—
題材 C の列は全部「—」。基準は題材 C の攻撃を 1 件も止めていない（第 4 章）。表にない攻撃は、別の要素が重ねて防いでいる
結果 results/summary.md 各題材の §除去実験：B から 1 つ
外すと
実装 cs/flags.py configs()（B-要素）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 1・3・4
10


# Page. 11

![Page Image](https://bcdn.docswell.com/page/47M6VDD2JW.jpg)

CHAPTER 2
題材 A マルチテナント
SaaS
この章で答えられるようになる問い
• 基準だけでは、どの攻撃が通るか
• 4 つの重点は、それぞれ何を止めるか
• 接続プールで、何がテナントを漏らすか
• 細かい権限をトークンに載せない代償は何か
テナントの境界を、トークン・発行者・鍵・データの 4 か所で守
る
11


# Page. 12

![Page Image](https://bcdn.docswell.com/page/P7RP2445J9.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 A の構成：テナントごとのレルムと、Postgres の RLS
t1・t2 の 2 つのレルム（実機）が発行し、API は 1 本のプールした接続で Postgres（RLS）を読む
重点の 4 要素
Keycloak レルム t1
alice／通常・軽量 AT・配列のクライアント
tenant_iss_bind
テナントのクレームが、発行したレルムと一致するか
API（saas-api）
Keycloak レルム t2
基準の検証・名前空間の
tenant_id
bob／rogue-web（tenant_id=t1 を出す）
Postgres 16
請求書の表・RLS
per_tenant_keys
署名鍵をテナントのレルムだけに登録する
1 本のプールした接続
t2 の連携先
data_tenant_check
渡した署名鍵で自分で発行
すべての SQL にテナントの条件（ID 指定・集計も）
rls_local
アクセストークンの寿命は 300 秒（レルムの設定）
結果 results/summary.md §A マルチテナント SaaS
実装 cs/scen_a.py Api・cases()／kc/import/t1.json・
t2.json（accessTokenLifespan 300）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
取引ごとに SET LOCAL で文脈を設定し、RLS で
絞る
ガイド ガイド Part 5（マルチテナント）・Part 7（データ層）
12


# Page. 13

![Page Image](https://bcdn.docswell.com/page/PJX3D22X7X.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 A の結果：基準（B）で 10 件中 5 件が残り、重点を足すと 0 件
基準で残るのは BOLA・接続プール・他テナントのマッパー・連携先の鍵（2 件）。正規の集計（A4）も基準では誤る
ID
内容
素朴（N）
基準（B）
A1
正規：t1 の利用者が自テナントの請求書を一覧
受理
受理
受理
A2
正規：t2 の利用者が自テナントの請求書を一覧
受理
受理
受理
A3
正規：t1 の利用者が自分の請求書を ID で読む
受理
受理
受理
A4
正規：t1 の利用者が集計 API で自テナントだけを得る
誤処理
誤処理
受理
A5
t2 のトークンで、パスとヘッダー X-Tenant を t1 にする
通る
拒否
拒否
A6
t1 の利用者が t2 の請求書の ID を直接指定（BOLA）
通る
通る
拒否
A7
t2 の文脈が残った接続で、条件を忘れた集計 API を t1 が呼ぶ
通る
通る
拒否
A8
t2 の管理者がマッパーで tenant_id=t1 を出させる（実機）
通る
通る
拒否
A9
t2 の連携先の鍵で、iss=t1・tenant=t1 のトークンを作る
通る
通る
拒否
A10
同じ鍵で、iss=t2 のまま tenant=t1 を名乗る
通る
通る
拒否
A11
軽量 AT で tenant が落ち、X-Tenant: t2 で既定を上書き
通る
拒否
拒否
A12
マッパーの誤りで tenant が配列 [&quot;t1&quot;,&quot;t2&quot;]
拒否
拒否
拒否
A13
ログインで得た ID トークンを API に送る
通る
拒否
拒否
A14
期限切れのトークン（発行から 400 秒後）
通る
拒否
拒否
結果 results/summary.md §A の表／results/scores.json
題材 A（素朴 9・基準 5・基準＋重点 0）
実装 cs/scen_a.py cases()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
基準＋重点（BE）
ガイド ガイド Part 5（BOLA・マルチテナント）・Part 7（接続プール
）
13


# Page. 14

![Page Image](https://bcdn.docswell.com/page/3JKYXMM97D.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 A の重点：照合と鍵は単独で効き、データ側は重ねがけ
基準＋重点（BE）から tenant_iss_bind を外すと A8・A10、per_tenant_keys を外すと A9 が再び通る
重点の要素
中身
BE から外すと再び通る
tenant_iss_bind
テナントのクレームが、発行したレルムと一致するか
A8、A10
per_tenant_keys
署名鍵をテナントのレルムだけに登録する
A9
data_tenant_check
すべての SQL にテナントの条件（ID 指定・集計も）
—（rls_local と重ねて防御）
rls_local
取引ごとに SET LOCAL で文脈を設定し、RLS で絞る
—（data_tenant_check と重ねて防御）
リーダーの視点
重ねがけは、片方の書き忘れに備える保険。BE で防げている 7
件（A5〜A7・A11〜A14）は、1 つ外しても防げたまま
A8 は実機の Keycloak で起きる
• t2 の管理者は、自分のレルムのマッパーで任意の tenant_id を出せる。
署名は正しいので、基準の 9 要素では止まらない
結果 results/summary.md §A 除去実験：BE から 1 つ外すと
実装 cs/scen_a.py Api._auth()（tenant_iss_bind）・
Api.__init__（per_tenant_keys）・get()・report()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 5（IR 8587 §5.2.1.2 の鍵のスコープ）・
Part 7
14


# Page. 15

![Page Image](https://bcdn.docswell.com/page/LE395YY9E5.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
接続プール：接続単位の文脈と、条件の書き忘れが重なると漏れる
SET LOCAL（取引単位）か SQL のテナント条件のどちらかがあれば A7 は止まる。両方なければ通る
構成
文脈の設定
SQL のテナント条件
A7
ほかの影響
BE
SET LOCAL（取引単位）＋ RLS
あり
拒否
—
BE~session
接続単位（よくある誤り）＋ RLS
あり
拒否
—
BE − data_tenant_check − rls_local
なし（RLS なし）
なし
通る
A6 も通る。正規の A4 を誤
処理
BE~session − data_tenant_check
接続単位 ＋ RLS
なし
通る
—
t2 の要求
同じ接続を再利用
t1 の集計 API
t2 の行が返る
接続に app.tenant=t2 を設定
文脈が残ったまま
テナント条件を書き忘れ
RLS は残った t2 で絞る
RLS を入れても、文脈を接続単位で設定すると守れない。SET LOCAL を共通の部品にする
結果 results/summary.md §A 接続プールの補足
実装 cs/flags.py（BE~session ほか 3 構成）／cs/scen_a.py
Api._run()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 7（接続プール・SET LOCAL）
15


# Page. 16

![Page Image](https://bcdn.docswell.com/page/8EDGD558EG.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 A の見送り：請求書ごとの許可は載せず、PDP で判定する
許可した請求書が 1,000 件でトークンは 6,563 バイト。PDP（DB）の判定は p50 548 µs
トークンの大きさ（バイト）：許可した請求書の件数ごと
7000
6,563
判定の時間（2,000 回）
• トークン内 p50 0.1 µs／PDP（DB）p50 548 µs・p95 693 µs
6000
5000
取り消しの反映
4000
• 載せると寿命 300 秒の間は古い（最大 300・平均 150 秒、設定か
らの計算）。PDP は即時
3000
失うこと
1,629
2000
1000
634
707
0件
20 件
• トークン単独では請求書ごとの許可を判定できない（毎回 PDP を引
く）
0
見直し条件
200 件
1,000 件
• 連携先に特定の請求書だけを一時的に渡す共有を、トークンで表す必
要が出たら
結果 results/measurements.json A.defer_fine_grained
／catalog/jwt-claims-catalog.xlsx CLM-0256（A）
実装 cs/scen_a.py defer_fine_grained()（2,000 回）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 4・5（変わりやすい権限は PDP で）
16


# Page. 17

![Page Image](https://bcdn.docswell.com/page/V7P3XGGWJ8.jpg)

CHAPTER 3
題材 B 社内業務システム
この章で答えられるようになる問い
• 入口の正規化は、何を解決するか
• IdP ごとの癖は、どこで事故になるか
• 厳しい基準が止めた 2 件の正規の要求を、どう通
すか
• 盗まれたトークンの再送を、なぜ見送るか
5 つの IdP のトークンを入口で内部トークンに正規化する。
厳しい基準は正規の要求も止める
17


# Page. 18

![Page Image](https://bcdn.docswell.com/page/2JV4L6697Q.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 B の構成：入口で IdP ごとに検証し、内部トークンに交換する
サービスは内部トークンだけを読む。旧来の入口は Keycloak のロールをヘッダー X-User-Role に写していた
Keycloak corp
実機
Entra ID
模擬
入口（ゲートウェイ）
• normalize_gw：IdP ごとの iss・typ・aud・必須
を検証し、内部トークン（at+jwt）に交換
• header_strip：x-user-* を大文字小文字・アン
ダースコア・重複を含めて除去
Okta
模擬
Cognito
• overage_resolve：groups が消えたらディレク
トリで引く
• 交換 p50 682 µs・p95 1,027 µs（2,000 回
）
模擬
社内のサービス
• 内部トークンだけを受ける
• freshness：経理・管理の操作は属性とセッション
を引き直す
フレームワークはヘッダー名を小文字にし、_
を - に変え、重複を「,」で連結する（CVE2026-26308 の型）
Auth0
模擬
内部トークン 967 B（Keycloak の AT 1,423 B）
結果 results/summary.md §B・§時間／
measurements.json perf・B.token_bytes
実装 cs/scen_b.py Gateway・Service・Env.normalize()／
kc/import/corp.json
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（IdP の実際）・Part 6（流れ）
18


# Page. 19

![Page Image](https://bcdn.docswell.com/page/5EG1XNN4JL.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
IdP ごとの癖：同じ情報が、IdP ごとに違う場所と形で来る
入口の正規化で IdP ごとに読み分け、内部トークンでは組織の名前空間に揃える。右端は、その癖を突くケース
IdP
種類（typ）
不変の ID
ロール
癖（ケース）
Keycloak（実機）
at+jwt（クライアント設定 rfc9068）
sub
realm_access.role
s
軽量 AT で sub・aud・組織のクレームが落ちる（A11）
Entra ID（模擬）
JWT
oid＋tid
groups
上限超過で groups が消える（B8・B9）。{tenantid} を何でも受けると別
の顧客テナント（B10）
Okta（模擬）
カスタム認可サーバーの AT。typ は
application/okta-internalat+jwt（文書で未確認）
uid
groups
sub はログイン名で再利用される（B13）。インラインフックが 3 秒で打ち切ら
れる（B15）
Cognito（模擬）
token_use=access
sub
cognito:groups
既定（resource なし）では AT に aud が無く client_id（B16）。custom:
は本人が書ける（B18）。フックで groups が消える（B19）
Auth0（模擬）
at+jwt（RFC 9068 プロファイル選択
時）
sub
組織の名前空間
名前空間の無い予約名 roles を黙って外す（B20）
内側のサービスに IdP ごとの読み分けを持たせない。癖は入口の 1 か所で吸収する
結果 summary.md §B／Okta Validate Access Tokens・
Auth0 AT Profiles・Cognito 文書
実装 cs/scen_b.py Env.verifier()／cs/jwtlib.py／kc
corp.json（rfc9068）／HDR-01
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（Entra ID・Keycloak・Okta・Cognito・
Auth0）
19


# Page. 20

![Page Image](https://bcdn.docswell.com/page/4JQD8QQR7P.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 B の結果：基準（B）で 18 件中 7 件が残り、重点で 1 件まで減る
素朴（N）では 18 件すべて通る。基準で 11 件止まり、重点でさらに 6 件。残る 1 件は意図した見送り
基準で止まる 11 件
重点で止まる 6 件
正規の要求 5 件
• B8 groups が消えた一般社員
• B4〜B6 ヘッダーの偽装（X-User-Role
・アンダースコア・重複）
• B1・B14・B21：3 つの構成すべてで受
理
• B10 別の顧客テナントの Entra
• B7 入口の迂回
• B13 Okta のログイン名の再利用
• B11 異動後の古い属性
• B9 Entra の groups 超過の管理者：基
準（B）で誤拒否 → BE で受理
• B15 フックの打ち切りで部署が欠ける
• B12 ログアウト後のトークン
• B2 ID トークン／B3 宛先の差し替え
• B16 既定の形で aud の無い Cognito
の AT：基準（B）で誤拒否 → BE で受理
• B17 Cognito の ID トークン
• B18 本人が書ける custom:role
• B19 フックで消えた groups
• B20 Auth0 が黙って外した roles
• B22 2^53 超の数値の社員番号
基準＋重点でも通る 1 件
• B23 盗まれたトークンの再送（意図した見
送り）
結果 results/summary.md §B の表／results/scores.json
題材 B（素朴 18・基準 7・基準＋重点 1）
実装 cs/scen_b.py cases()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3・4・6・8
20


# Page. 21

![Page Image](https://bcdn.docswell.com/page/K74Z2NNQE1.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
ヘッダーの偽装：除去と正規化は重ねがけ
B4〜B7 は基準では止まらない。入口の迂回（B7）は正規化でしか止まらない
ケース
手口
基準（B）
基準＋重点（BE）
BE から外すと
B4
クライアントが X-User-Role: admins を付ける
通る
拒否
重ねて防御
B5
アンダースコア版 X_User_Role（CVE-2025-64484 の型）
通る
拒否
重ねて防御
B6
小文字の x-user-role を足して重複させ、値を連結（CVE-202626308 の型）
通る
拒否
重ねて防御
B7
入口を通らず、サービスに直接、正しいトークンと偽のヘッダー
通る
拒否
normalize_gw を外すと通る
リーダーの視点
ヘッダーの除去は入口にしか置けない。入口を迂回されたときの最後の砦は、サービスが「内部トークンだけを受ける」こと
結果 results/summary.md §B の表・§B 除去実験：BE から
1 つ外すと
実装 cs/scen_b.py Gateway.forward()（header_strip）・
Service.org()・headers_seen()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 6（ヘッダーへの転記・検証の分担）
21


# Page. 22

![Page Image](https://bcdn.docswell.com/page/LJ1RM55LJG.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
厳しい基準の誤拒否 2 件は、基準を緩めず入口で直す
B9（Entra の groups 超過の管理者）と B16（既定の形の Cognito の AT）。重点を足すと誤拒否は 0
B9 Entra の groups 超過の管理者
B16 aud の無い Cognito の AT（既定の形）
原因
原因
• 250 グループで groups が消え、必須のロールが欠ける → required
が拒否
• 既定（resource なし）の Cognito の AT は aud が無く client_id で
宛先を表す → aud の確認が拒否
基準を緩めると
基準を緩めると
• required を外すと B9 は通るが、B8（一般社員）と B15（フックの打ち
切り）が再び通る
• aud を外すと B16 は通るが、B3（宛先の差し替え）が再び通る
重点で通す
重点で通す
• overage_resolve：groups が消えたらディレクトリで引く。BE から外
すと B9 は再び拒否
• normalize_gw：入口で Cognito だけ client_id を照合し、内部トーク
ンに aud を入れる
結果 results/summary.md §B 除去実験（B から・BE から 1
つ外すと）
実装 cs/scen_b.py Env.normalize()（overage_resolve）・
Gateway.forward()（Cognito の client_id）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（Entra ID の groups 超過・Cognito）
22


# Page. 23

![Page Image](https://bcdn.docswell.com/page/GJW1355QE2.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
属性の鮮度：重要な操作だけ引き直せば、異動とログアウトがすぐ効く
freshness を外すと、B11（異動後の古い属性）と B12（ログアウト後のトークン）が再び通る
B11 異動後の古い属性
• finance から sales に異動した直後、古いトークンで経理台帳を読む
B12 ログアウト後のトークン
近い操作の費用（200 回。freshness そのも
のではない）
p50
p95
イントロスペクション
8.9 ms
31.8 ms
ディレクトリ参照（管理用トークンの取得を含む）
50.7 ms
75.6 ms
Keycloak の実機：ログアウトの後
• セッション失効後に、残ったトークンで経理台帳を読む
• イントロスペクションは 20 回すべて最初の確認で inactive（最大
26.8 ms）。JWT は 299 秒以上残る
ポイント
自己完結のトークンだけでは、ログアウトしても寿命まで使える。重要な操作だけ問い合わせる（寿命の試算は第 5 章）
結果 measurements.json B.freshness・
logout_introspection／Keycloak 文書（aud 確認）
実装 cs/scen_b.py Service.fresh()・freshness_cost()／
cs/kcmeasure.py logout_introspection()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 8（寿命の間のクレーム・失効の伝播）
23


# Page. 24

![Page Image](https://bcdn.docswell.com/page/4EZPVNN3J3.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 B の見送り：盗まれたトークンの再送は基準＋重点（BE）でも通る
送信者制約（DPoP・mTLS）と JWE は入れない。費用は小さいが、クライアントの鍵管理の手間を避けた
項目（2,000 回）
大きさ
時間 p50
JWS（いまの形）
670 B
検証 83.0 µs
JWE（入れ子）
1,345 B
暗号化 142 µs／復号 628 µs
DPoP の証明
498 B
作成 99 µs／検証 97 µs
失うこと
• トークンを持つ者は誰でも使える（B23）。中継者から中身を隠せ
ない
見直し条件
• トークンが社外・取引先へ渡るようになったとき、または盗用の兆
候が見えたとき
注意
測ったのは送信者制約の費用だけ。DPoP で B23 が止まることは、この実験では測っていない（未検証）
結果 measurements.json B.defer_crypto／summary.md
§見送りの代償／一覧表 CLM-0431（B）
実装 cs/scen_b.py defer_crypto()・B23／
catalog/DECISION_POLICY.md §ケースごとの重点
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 2（cnf）・Part 8（送信者制約）・Part 9（JWE）・
Part 6
24


# Page. 25

![Page Image](https://bcdn.docswell.com/page/Y76M588ZEV.jpg)

CHAPTER 4
題材 C AI エージェントの
委任
この章で答えられるようになる問い
• なぜ共通の基準が効かないのか
• 5 つの重点は、それぞれ何を止めるか
• 人の承認を、どうトークンに束縛するか
• 委任の深さを、標準がない中でどう決めるか
攻撃のトークンはすべて正しく署名され、期限内。共通の基準
は 1 件も止めない
25


# Page. 26

![Page Image](https://bcdn.docswell.com/page/G75ZY999J4.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 C の構成：利用者 → エージェント → MCP のツール → API
内部のトークン発行サービス（模擬、仮想の時計）が委任と交換を担う。呼び出し元はワークロードの ID で識別する
MCP のツール
利用者 u1
エージェント
委任に同意
agent:expense（act.sub）
tool:invoice-mcp：交換で act を
重ねる
請求書 API
invoices：行為者と承認を照合
act_chain
aud_exchange
approval_bind
short_task
depth_rule
• 最も外側の act（今の行
為者）と呼び出し元を照
合
• ホップごとに単一の宛先
で交換。受け取ったトー
クンを渡さない
• 承認は
authorization_detai
ls で金額と相手先を照
合
• 300 秒・タスクの範囲
だけ。交換時に取り消し
を再確認
• 委任の連鎖は 3 段まで
（組織の規則）
Keycloak 26.8 の標準トークン交換も測った。交換結果に act は無かった（第 5 章）
結果 results/summary.md §C AI エージェントの委任
実装 cs/scen_c.py TokenService・Tool・Resource
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 10（エージェントの ID・MCP の認可）
26


# Page. 27

![Page Image](https://bcdn.docswell.com/page/9J2RG2257R.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 C の結果：基準（B）では 12 件すべて通り、重点を足すと 0 件
攻撃のトークンはどれも正しい発行者が署名し、期限内。問題は「誰が・何のために・どこまで」使うか
ID
内容
素朴（N）
基準（B）
C1
正規：エージェントがツール経由で u1 の請求書を読む
受理
受理
受理
C2
ツールが受け取ったトークンを、そのまま上流に渡す
通る
通る
拒否
C3
u1 の委任で、ツールに u2 の請求書を読ませる（代理の混乱）
通る
通る
拒否
C4
過去の行為者（管理コンソール）の権限で、読み取り専用のエージェントが支払う
通る
通る
拒否
C5
120,000 円の承認で 990,000 円を支払う
通る
通る
拒否
C6
承認の金額のまま、振込先を別の口座に変える
通る
通る
拒否
C7
存在しない承認 ID を本文に書いて支払う
通る
通る
拒否
C8
正規：承認どおり 120,000 円を B-019 に支払う
受理
受理
受理
C9
委任の取り消し後（発行から 9 分）に読む。BE では寿命 300 秒切れで拒否
通る
通る
拒否
C10
5 段の委任の連鎖で読む
通る
通る
拒否
C11
正規：2 段の委任の連鎖で読む
受理
受理
受理
C12
エージェントが利用者自身のトークン（act なし）を借りて支払う
通る
通る
拒否
C13
resource なしの広い宛先のトークンを、悪意ある MCP サーバー mcp-b が mcp-a に再送
通る
通る
拒否
C14
読む・払うだけのタスクで、ツールが返金の範囲を求めて返金する
通る
通る
拒否
C15
ツールが交換で sub を u2 に差し替えて、u2 の請求書を読む
通る
通る
拒否
結果 results/summary.md §C の表／results/scores.json
実装 cs/scen_c.py cases()
題材 C（素朴 12・基準 12・基準＋重点 0）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
基準＋重点（BE）
ガイド ガイド Part 10（4 つの問い・人の承認の証拠・委任の連鎖）
27


# Page. 28

![Page Image](https://bcdn.docswell.com/page/DEYDVYY6EM.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材 C の重点：5 つの要素が、それぞれ別の攻撃を止めている
基準＋重点（BE）からどの要素を外しても攻撃が再び通る。重ねて防いだのは C2・C12 だけ
重点の要素
中身
外すと再び通る
外すと誤拒否
act_chain
最も外側の act を今の行為者として、呼び出し元と照合
C4
—
aud_exchange
ホップごとに単一の宛先で交換し、受け取ったトークンを渡さない
C3、C13、C15
C8（承認は交換で載る）
approval_bind
authorization_details の金額と相手先を照合
C5、C6、C7
—
short_task
300 秒・タスクの範囲だけ。交換時に取り消しを再確認
C9（寿命切れ）、C14
—
depth_rule
委任の連鎖は 3 段まで
C10
—
リーダーの視点
aud_exchange を外すと正規の支払い C8 も失敗する。承認の束縛は交換の上に乗っている。重点は組で入れる
結果 results/summary.md §C 除去実験：BE から 1 つ外すと
実装 cs/scen_c.py TokenService.exchange()・
Resource.check()・pay()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 10（4 つの問い・ツールごとのスコープ）
28


# Page. 29

![Page Image](https://bcdn.docswell.com/page/VJN6MPR1J8.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
承認の証拠：交換で金額と相手先をトークンに載せる
approval_bind が無いと、本文の承認 ID をそのまま信じるので C5〜C7 が通る
&quot;authorization_details&quot;: [{
&quot;type&quot;: &quot;https://claims.example.com/rar/payment&quot;,
&quot;actions&quot;: [&quot;pay&quot;],
&quot;identifier&quot;: &quot;inv-1&quot;,
&quot;instructedAmount&quot;: {
&quot;currency&quot;: &quot;JPY&quot;, &quot;amount&quot;: &quot;120000&quot; },
&quot;creditorAccount&quot;: &quot;B-019&quot;
}]
交換のとき
• 承認の記録を引く（CIBA の代わり）。無い・持ち主が違えば交換を拒
否（C7）
支払いの API
• 請求書・金額・相手先が一致しなければ拒否（C5・C6）
費用：委任の発行＋交換の 2 段で、タスクごとに p50 1,182 µs／p95 1,548 µs（2,000 回、承認の参照は含まない）
RFC 9396 §2.2 では locations は RS の場所。個別の請求書は identifier に入れる（実験・一覧表・ガイド S125 とも identifier）
結果 results/measurements.json C.sts_exchange／
summary.md §C 除去実験／RFC 9396 §2.2
実装 cs/scen_c.py APPROVALS・
TokenService.exchange()・Resource.pay()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 10 S125（人の承認の証拠）
29


# Page. 30

![Page Image](https://bcdn.docswell.com/page/YE9LN3MY73.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
委任の深さは標準がない。組織の規則で 3 段までにする
depth_rule を外すと 5 段の連鎖（C10）が通る。2 段（C11）は BE でも受理
&quot;act&quot;: {
&quot;sub&quot;: &quot;tool:invoice-mcp&quot;,
&quot;act&quot;: {
&quot;sub&quot;: &quot;agent:expense&quot;
}
}
← 今の行為者
組織の規則
• 交換のときと受け手で、深さが 3 を超えたら拒否
← 過去の経路
深さ 2
見送り
• 標準による深さの強制（標準がないため）
失うこと
act_chain を外すと、内側の過去の行為者を今の行為者と読み違え
、読み取り専用のエージェントが支払える（C4）
• 組織の外の発行者・受け手には、この上限が伝わらない
見直し条件
• 委任の深さ・縮小を規定する標準（WG 草案以上）が出たら
結果 results/summary.md §C 除去実験／catalog/jwtclaims-catalog.xlsx CLM-0369（C）
実装 cs/scen_c.py chain()・depth()・MAX_DEPTH=3
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 10（委任の連鎖と深さ）／
research/outline.md §ケーススタディの方針
30


# Page. 31

![Page Image](https://bcdn.docswell.com/page/GE8XKMLKJD.jpg)

CHAPTER 5
測定：Keycloak 26.8・
寿命・大きさ・変更
この章で答えられるようになる問い
• Keycloak の交換・イントロスペクション・リフレッシ
ュは実際どう動くか
• グループの数で、トークンはどこまで大きくなるか
• 寿命と問い合わせの方式で、古い判断はどれだけ残
るか
• 共有クレームを変えると、何が壊れ、何が見つかるか
文書だけでは分からない製品の挙動と、トレードオフを数字
で示す
31


# Page. 32

![Page Image](https://bcdn.docswell.com/page/LEL8Z3LP7R.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
Keycloak 26.8 の標準交換：元のトークンに無い宛先へ広げられる
optional scope の aud-orders を求めると、元に無い orders 宛てが 200 で出た
試験
要求
結果
交換後の aud
交換後の scope
narrow_to_invoices
audience=invoices・scope=audinvoices
200
invoices
aud-invoices email
profile
audience_not_in_scope
audience=invoices だけ
400 Requested audience
not available
—
—
audience_not_configured
audience=orders-admin（設定に無い）
400 Audience not found
—
—
scope_not_granted
scope=aud-orders だけ（optional
scope）
200
orders・account
aud-orders email
profile
no_audience_no_scope
指定なし
200
account
email profile
元のトークン（portal でログイン、scope aud-mcp）の aud：mcp-tools・account。交換 200 回：p50 9.7 ms／p95 31.3 ms。交換結果に act は無い
リーダーの視点
交換は元のトークンの宛先に縛られない。downscope-assertion-grant-enforcer で絞り込みだけに限り、受け手で aud を 1 つに限
る（題材 C の aud_exchange）
結果 measurements.json C.keycloak_exchange／
Keycloak 文書（Token exchange・downscoping）
実装 cs/scen_c.py keycloak_exchange()／cs/infra.py
CORP_OPTIONAL
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 10（トークン交換）・Part 3（Keycloak）
32


# Page. 33

![Page Image](https://bcdn.docswell.com/page/4JM6VDM2EW.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
Keycloak 26.8 のイントロスペクションは、宛先のクライアントだけ
active=true は aud の orders だけ。発行した portal でも false（3 クライアントで各 1 回）
イントロスペクション
ログアウトの後
リフレッシュ
• orders（aud）：true
• 20 回すべて、最初の確認で inactive
• portal（発行したクライアント）：false
• 最大 26.8 ms
• 発行時：department=sales・auditor
なし
• mcp-tools：false
• JWT 自体は 299 秒以上有効のまま
• リフレッシュ後：finance・auditor あり
• 再ログインも同じ
• 問い合わせる受け手を aud に入れる
• RT は入れ替わった（Revoke Refresh
Token を有効にしたレルム）
ポイント
リフレッシュで属性とロールは再評価される。古さの上限はアクセストークンの寿命（このレルムは 300 秒。設定値からの推論）
結果 measurements.json keycloak（logout・refresh）／
Keycloak 文書（aud 確認）
実装 cs/kcmeasure.py／kc/import/corp.json（
revokeRefreshToken・寿命 300）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（Keycloak）・Part 8（リフレッシュ・失効）
33


# Page. 34

![Page Image](https://bcdn.docswell.com/page/PJRP24V5E9.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
Keycloak 26.8 の軽量 AT は sub・aud・組織のクレームも落とす
通常 20 個のクレームが、軽量では 8 個。設定 1 つでテナントの境界の根拠が消える（A11）
項目
測った結果
設計への意味
軽量アクセストークン
20 → 8 クレーム。落ちた 12：acr・aud・email・email_verified・
family_name・given_name・組織の名前空間・name・preferred_username
・realm_access・resource_access・sub
必須のクレームが欠けたら拒否する（required）
Full Scope Allowed
オン：要らない tenant-admin が漏れる／オフ：realm_access が空
オフにし、要るロールだけ割り当てる（この設定は非
推奨で、将来削除予定）
定義していない利用者属性
ENABLED：保存される／既定（無効）：保存されず、HTTP エラーも無い
黙って消える。属性はユーザープロファイルで定義す
る
Organizations
organization クレームは既定で配列 [&quot;acme&quot;]（マッパーの設定でオブジェクト
にもなる）
型を固定する（types）。マッパーの設定を変えたら
型も見直す
結果 measurements.json keycloak.lightweight ほか／
Keycloak 管理ガイド
実装 cs/kcmeasure.py／kc/import/t1.json（saas-light・
fs-on・fs-off）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（Keycloak）・Part 4（型・必須）
34


# Page. 35

![Page Image](https://bcdn.docswell.com/page/PEX3D2ZXJX.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
グループをトークンに載せると、200 個で 8,609 バイトになる
Keycloak：グループ 0 個 1,394 B → 200 個 8,609 B。軽量アクセストークンは 759 B のまま
トークンの大きさ（バイト）：グループの数ごと
ほかの大きさ
バイト
Keycloak のアクセストークン
1,423
内部トークン（題材 B）
967
Entra 形式・150 グループ
8,650
Entra 形式・超過で groups が消えた
1,042
10000
8,609
9000
8000
7000
6000
5,009
5000
4000
3,209
3000
2000
1000
1,769
1,394
759
759
759
759
759
ロールの数がトークンの上限に近づいたら、
PDP で都度引く方式に移す（一覧表 ORG03 の見直し条件）
0
0個
10 個
50 個
全量（グループのマッパーあり）
結果 measurements.json keycloak.groups_size・
B.token_bytes／一覧表 ORG-03
100 個
200 個
軽量アクセストークン
実装 cs/kcmeasure.py groups_size()／cs/scen_b.py
run()
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（Entra の groups 超過）・Part 4
35


# Page. 36

![Page Image](https://bcdn.docswell.com/page/3EKYXM89JD.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
寿命の試算：寿命が長いほど、古い情報での判断が増える
1,000 人・1 時間・1 人 2 件／分・重要な操作 5%・属性は 1 人 1 回変わる・乱数の種 20261117
寿命
方式
古い判断
1分
自己完結のみ
984
55
59
122
61,000
重要な操作だけ問い合わせ
929
0
56
122
67,109
0
0
30
91
181,249
自己完結のみ
4,950
258
177
313
13,000
重要な操作だけ問い合わせ
4,692
0
149
302
19,109
0
0
30
91
133,249
自己完結のみ
14,358
777
452
872
5,000
重要な操作だけ問い合わせ
13,581
0
284
747
11,109
0
0
30
91
125,249
自己完結のみ
40,883
2,096
1,231
2,861
2,000
重要な操作だけ問い合わせ
38,787
0
430
1,267
8,109
0
0
30
91
122,249
毎回問い合わせ
5分
毎回問い合わせ
15 分
毎回問い合わせ
60 分
毎回問い合わせ
結果 results/summary.md §寿命の試算／
results/measurements.json lifetime
うち重要
古さ平均（秒）
実装 cs/lifetime.py simulate()（seed=20261117）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
p95（秒）
認可サーバーへの呼び出し／時
ガイド ガイド Part 8（寿命と失効）
36


# Page. 37

![Page Image](https://bcdn.docswell.com/page/L7395Y2975.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
重要な操作だけ問い合わせると、重要な古い判断は 0（モデル上）
毎回問い合わせに比べた呼び出しは、寿命 1 分で 37%、5 分で 14%、15 分で 8.9%、60 分で 6.6%
認可サーバーへの呼び出し／時（寿命ごと。値は前の表）
寿命
重要だけ÷毎回
重要でない古い判断
1分
37%
929
5分
14%
4,692
15 分
8.9%
13,581
60 分
6.6%
38,787
200000
180000
160000
140000
120000
100000
80000
60000
リーダーの視点
重要な操作だけ問い合わせる（題材 B の
freshness）。比は 1 つの数字でなく、寿
命ごとの値で伝える
40000
20000
0
1分
自己完結のみ
5分
15 分
重要な操作だけ問い合わせ
結果 results/measurements.json lifetime（
as_calls_per_hour・stale_critical_decisions）
毎回問い合わせ
実装 cs/lifetime.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
60 分
ガイド ガイド Part 8（寿命の間のクレーム）
37


# Page. 38

![Page Image](https://bcdn.docswell.com/page/87DGD5Z87G.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
費用の一覧：基準の検証はほぼ無料。重い費用は外部への問い合わせ
時間は p50／p95、回数を併記。同じ PC（Ryzen 7 3700X・Python 3.14.6・PyJWT 2.10.1）での値
測定
p50
p95
回数
検証（素朴）
82.3 µs
138.2 µs
5,000
検証（共通の基準）
84.2 µs
108.4 µs
5,000
入口の交換（Entra 形式 → 内部トークン）
682 µs
1,027 µs
2,000
142／628 µs
202／899 µs
2,000
99／97 µs
153／142 µs
2,000
548 µs
693 µs
2,000
1,182 µs
1,548 µs
2,000
Keycloak の標準トークン交換
9.7 ms
31.3 ms
200
イントロスペクション（Keycloak）
8.9 ms
31.8 ms
200
50.7 ms
75.6 ms
200
JWE の暗号化／復号
DPoP の証明の作成／検証
PDP（DB）の判定
題材 C のタスクごとの 2 段の発行
ディレクトリ参照（管理用トークンの取得を含む）
結果 results/measurements.json perf（reps）・
B.defer_crypto・B.freshness・A・C
実装 cs/scen_a.py・scen_b.py・scen_c.py の測定関数
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 6・8・9
38


# Page. 39

![Page Image](https://bcdn.docswell.com/page/VJP3XGDWE8.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
共有クレームの変更：10 の変更のうち 8 つで黙って誤る
9 つの受け手（Python・JS・Go・Envoy・CEL・SQL の RLS・K8s・Java・旧システム）× 10 の変更
変更
壊れた
うち黙って誤る
契約テストで検出
共通の部品
roles：空白区切り → 配列
6
0
6
正しく処理
roles：空白区切り → カンマ区切り
7
7
0
正しく処理
employee_id：文字列 → 2^53 超の数値
5
4
3
正しく処理
tenant：大文字に変わる（T1）
9
9
5
正しく処理
roles：組織の URL 名前空間へ移す
9
4
9
正しく処理
roles：名前を role に変える
9
4
9
正しく処理
mfa：無い（=false）から null に
2
2
2
正しく処理
mfa：真偽値を文字列 &quot;false&quot; に
3
2
3
拒否（fail closed）
制限のクレーム ip_allow を追加
9
9
0
正しく処理
sub：ログイン名 → 不変の UUID（user_id は残す）
1
0
1
正しく処理
結果 results/summary.md §共有クレームを変えたとき／
results/measurements.json change
実装 cs/change.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 4（型）・Part 11（契約テスト・変更の手順）
39


# Page. 40

![Page Image](https://bcdn.docswell.com/page/2EV4L619JQ.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
契約テストは万能ではない。共通の部品は 10 の変更を受け止めた
契約テストで全部は見つからない変更が 4 つ。共通の部品は 9 つを正しく処理し、1 つは拒否（fail closed）した
employee_id を数値に
形は同じで意味が変わる
共通の部品で読む
• 壊れた 5 つのうち、契約テストが見つけた
のは 3 つ
• カンマ区切り：7 つ壊れ、検出 0
• 10 の変更のうち 9 つを正しく処理
• ip_allow の追加：9 つ壊れ、検出 0
• mfa の文字列化は拒否（fail closed）
• 見逃し：Kubernetes の
claimMappings、sub をキーにする旧
システム
• tenant の大文字：9 つ壊れ、検出 5
• 誤って許可した変更は 0
リーダーの視点
共有クレームの変更は、契約テスト＋共通の部品＋変更の手順の 3 つで守る。「検出できる」は何件中何件かを添えて言う
結果 measurements.json change／summary.md §共有ク
レームを変えたとき
実装 cs/change.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 11（契約テスト・変更の手順）
40


# Page. 41

![Page Image](https://bcdn.docswell.com/page/57G1XN24EL.jpg)

CHAPTER 6
判断：付録の一覧表と題材
ごとの結論
この章で答えられるようになる問い
• 付録の一覧表には何が載っているか
• 判定はどう決め、誰が点検したか
• 題材ごとに何を採用し、何を見送るか
• 明日から何をするか
805 行のクレームそれぞれに、題材 A・B・C での判定、条件
、失うこと、見直し条件
41


# Page. 42

![Page Image](https://bcdn.docswell.com/page/4EQD8QPRJP.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
付録の一覧表：805 行。クレームを、定義した出典ごとに 1 行で集めた
行数はクレームの数ではない。同じ概念は同義グループ（204）で束ねる
出典の種別
行数
ベンダー独自（Entra・Keycloak・Auth0・Okta・Cognito）
234
標準（IETF RFC）※JOSE ヘッダー 10 行を含む
185
プラットフォーム独自（GitHub Actions・Kubernetes など）
153
主な列
• 意味（表すこと／表さないこと）・値の型・載るトークン
• 出典（節）・URL・書籍の該当箇所
• IdP での扱い（5 社）
標準（OpenID Foundation 最終版）
106
• 値を書ける主体・可変性・鮮度
草案（IETF・OIDF）
50
• 認可に使ってよいか・個人情報・ログ方針
業界の属性語彙（SCIM・eduPerson など）
26
• 題材 A・B・C ごとの判定・条件・代替クレーム・用途／失う
こと・見直し条件・検証 ID
公的機関・研究
25
IANA 登録（その他の標準化団体）
15
本ケーススタディで定義（組織の独自クレーム）
11
合計
結果 catalog/catalog.json（source_kind・synonym_group
を集計）／README.md §付録
805
実装 catalog/SCHEMA.md／catalog/scripts/merge.py・
header_rows.py・build_xlsx.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 2・3（既存のクレームの地図）
42


# Page. 43

![Page Image](https://bcdn.docswell.com/page/KJ4Z2NYQ71.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
判定の作り方：共通の前提で決め、書いた担当とは別の担当が点検した
方針 → 判定 → 列の設計のレビュー → 判定の点検 → 修正はスクリプトで残す。空欄のセルは無い
方針
判定
別の担当の点検
検証
入口で内部トークンに交換。IdP 固
有は原則「不採用・代替あり」
7 つの値。採用は使う場面、不採用
は失うこと、見直し条件は全行に書く
列の設計：15 列を追加／判定：216
行を全件＋約 70 行、指摘 9 件
欠け 0・重複 0・問題 0。空欄のセル
なし
判定の値
必須（共通基準）
採用
条件付き採用
不採用・代替あり
不採用・不要
不採用・禁止
対象外
点検の指摘の例：DPoP の証明に要る iat・jti を「不要」にしていた／送信者制約の採用を「実験で未検証」と明記していなかった
結果 catalog/reviews/（列・判定のレビュー 2026-11-17）／
decisions/validation.json
実装 catalog/DECISION_POLICY.md／
scripts/fix_review1.py・fix_blanks.py・validate.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 11（台帳・レビュー）
43


# Page. 44

![Page Image](https://bcdn.docswell.com/page/LE1RM56LEG.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
判定の件数：使うのは題材 A 57・題材 B 112・題材 C 55 行
805 行のうち、どの題材でも約 7〜14% だけを使う。不採用には失うことを、全行に見直し条件を書いた
判定
題材 A
題材 B
題材 C
未検証の推奨
必須（共通基準）
16
16
16
採用
7
8
17
条件付き採用
34
88
22
不採用・代替あり
112
80
116
不採用・不要
285
260
252
不採用・禁止
48
50
80
送信者制約（cnf・cnf.jkt と DPoP の証明の iat・jti）は
題材 A・C で「条件付き採用」。
これは推奨で、この実験では効果を測っていない（未検証の
追加防御）。題材 B は見送りのため不採用（B23）
「禁止」の例
対象外
303
303
302
合計
805
805
805
結果 decisions/part*.json＋HDR-01〜10 を集計／xlsx「判
定（縦長）」で照合
• アクセストークンに個人情報を載せる
• 本人が書き換えられる属性で認可する
実装 catalog/scripts/build_xlsx.py・header_rows.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 2 S27（cnf）・Part 8 S107（送信者制約）
44


# Page. 45

![Page Image](https://bcdn.docswell.com/page/GEW135WQ72.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
一覧表の使い方：自分に近い題材の列で絞り、条件と見直し条件を読む
判定はこのケーススタディの前提での、2026-11-17 時点の結論。自組織の前提で書き換えて台帳にする
1. 近い題材を選ぶ
2. 判定で絞る
3. 理由を読む
• 題材 A マルチテナント SaaS・題材 B 社内
業務システム・題材 C AI エージェントの委任
• 必須・採用・条件付き採用が、使うクレームの
候補
• 条件・用途／失うこと・見直し条件
4. 代替へ飛ぶ
5. 根拠へ飛ぶ
6. 自分の台帳にする
• 不採用・代替ありは、代替クレーム（ID）の行
へ
• 検証 ID → 結果、ガイドの該当 Part → ガ
イド
• 前提が違うところは判定を書き換える
一覧表（xlsx）：https://github.com/Takenori-Kusaka/jwt-claims-casestudy/blob/main/catalog/jwt-claims-catalog.xlsx
IdP で「既定」でも、認可に使ってよいとは限らない。「認可に使ってよいか」「値を書ける主体」「可変性」を必ず見る
結果 catalog/jwt-claims-catalog.xlsx（読み方のシート）
実装 catalog/scripts/links.py（行内・結果・ガイドへのリンク）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 11（クレームの台帳）
45


# Page. 46

![Page Image](https://bcdn.docswell.com/page/47ZPVN53E3.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
題材ごとの判断：基準は全題材で同じ。重点と見送りは題材で変える
見送りには、見送るもの・失うこと・見直し条件・検証 ID を書いて残す
題材
重点（基準 9 要素に足す）
見送るもの
失うこと
見直し条件
検証 ID
題材 A マルチテナント
SaaS
tenant_iss_bind・
per_tenant_keys・
data_tenant_check・rls_local
請求書ごとの許可をトークンに載せ
る（PDP で都度、p50 548 µs）
トークン単独では請求書ごとの許
可を判定できない
連携先に特定の請求書だけを一時的
に渡す共有を、トークンで表す必要が
出たら
—（費用だけ測
定）
題材 B 社内業務シス
テム
normalize_gw・header_strip・
freshness・overage_resolve
送信者制約（DPoP・mTLS）・JWE
盗まれたトークンを誰でも使える
。中継者から中身を隠せない
トークンが社外・取引先へ渡るとき、ま
たは盗用の兆候
B23
題材 C AI エージェン
トの委任
act_chain・aud_exchange・
approval_bind・short_task・
depth_rule
標準による委任の深さの強制（組織
の規則 3 段で代える）
組織の外の発行者・受け手には上
限が伝わらない
委任の深さ・縮小を規定する標準（
WG 草案以上）が出たら
C10・C11
題材 A・C の送信者制約（cnf.jkt・DPoP）の条件付き採用は推奨。この実験では効果を測っていない
結果 summary.md／DECISION_POLICY.md §ケースごとの
重点／一覧表 CLM-0256・0369・0431
実装 cs/flags.py EMPH
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 5・6・8・9・10
46


# Page. 47

![Page Image](https://bcdn.docswell.com/page/YJ6M589Z7V.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
限界：模擬の IdP、1 台の PC、測っていない推奨がある
数字はこの実験の前提でのもの。製品の版、利用者の行動、組織の前提が違えば変わる
• 模擬の IdP：Entra ID・Okta・Cognito・Auth0 は 2026-11 の公式文書の形。実際の挙動のすべてではない
• 実機は 2 つ：Keycloak 26.8.0 と Postgres 16。版が変われば挙動も変わりうる
• 誤りの再現：要素を外した構成は過去の誤りを手で再現。PyJWT 2.10 は数値の sub などを自分で拒否する（G14）
• 1 台の PC：Ryzen 7 3700X・Python 3.14.6 での時間。絶対値より比で読む
• 寿命はモデル：1,000 人・1 人 2 件／分・重要 5%・1 人 1 回の変更・乱数の種 20261117
• 未検証の推奨：送信者制約（DPoP・mTLS）は費用だけを測り、効果（B23 を止めるか）は測っていない
• 題材 C は模擬の上：重点は模擬のトークン発行サービスで確認。Keycloak の標準交換では act が出ない
• 9 つの受け手：よくある書き方を再現した実装で、各製品・ライブラリそのものではない
• 前提：題材 C は、呼び出し元をワークロードの ID（mTLS など）で識別できるとした
• 点検：判定と資料の点検は、作成とは別の生成 AI（Claude）のサブエージェントが担当
• 判定の時点：一覧表の判定は 2026-11-17 時点、このケーススタディの前提での結論
結果 README.md §注意／results/summary.md §環境・
§Keycloak 26.8（act なし）
実装 cs/lifetime.py（モデル）／cs/flags.py（誤りの再現）／
cs/change.py（9 つの受け手）
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 3（IdP の実際）・Part 9
47


# Page. 48

![Page Image](https://bcdn.docswell.com/page/GJ5ZY9N9E4.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
最初の一歩：基準を共通の部品にし、正規の要求を IdP ごとに試す
測った結果から、テックリーダーが最初にやること 5 つ。順番・担当・終わりの基準つき
1
9 要素を共通の検証部品に入れる（検証部品の担当）
2
正規の要求を IdP ごとに用意し、誤拒否を数える（検証部品の担当）
3
重点を選び、除去実験で効きを確かめる（サービスの担当）
4
見送りを台帳に残す（台帳の担当）
5
共有クレームの変更は、契約テスト＋共通の部品で受ける（台帳の担当）
終わり：全サービスが部品経由で、汎用の攻撃 G1〜G14 の通過が 0。費用は p50 82.3 → 84.2 µs
指標：IdP ごとの誤拒否の件数。B9・B16 は攻撃のテストでは見えない
run_all.py を自分の構成に置き換えて流す。重ねがけの要素は組で外して確かめる
見送るもの・失うこと・見直し条件・検証 ID を書き、見直し条件を定期的に確かめる
指標：変更ごとの壊れた受け手と検出の数。契約テストだけでは employee_id で 5 つ中 3 つ
結果 results/summary.md（各章の結果）／
results/measurements.json perf・change
実装 run_all.py／cs/verify.py／cs/flags.py／
cs/change.py
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Part 11（ガバナンス）・Part 12（実践）
48


# Page. 49

![Page Image](https://bcdn.docswell.com/page/LE395Y22E5.jpg)

前提
構成
汎用
題材 A
題材 B
題材 C
測定
判断
リンク：ガイド・ケーススタディ・付録の一覧表
ガイドで原則を、このリポジトリで実験の手順と結果を、一覧表で個々のクレームの判定を確かめる
ガイド（Web 版、152 枚）
https://takenori-kusaka.github.io/jwt-claims-guide/
ガイドのリポジトリ（PDF・PPTX）
https://github.com/Takenori-Kusaka/jwt-claims-guide
このケーススタディ（実験・結果）
https://github.com/Takenori-Kusaka/jwt-claims-casestudy
付録：JWT クレーム一覧（xlsx、805 行）
https://github.com/Takenori-Kusaka/jwt-claims-casestudy/blob/main/catalog/jwt-claims-catalog.xlsx
文章・データ・一覧表は CC BY 4.0、コードは MIT。本資料は生成AI（Claude）を使って作成し、筆者が確認して公開しています。
結果 README.md（冒頭・実行・ライセンス）
実装 run_all.py／LICENSE・LICENSE-CONTENT.md
JWT クレーム設計ケーススタディ｜共通の基準・重点・見送りを測る
ガイド ガイド Web 版・リポジトリ
49


