SPECIFICATION
CAP プロトコル技術仕様(ドラフト)
本ディレクトリは Control Authority Protocol(CAP)v1 技術仕様のドラフト版である。本仕様は docs/ja/blueprint/ のアーキテクチャブループリントに基づき策定され、ブループリント第 3 章 §3.1 に列挙された 6 つのコア能力をカバーする。
ドキュメント構成
| 章 | ファイル | 内容 |
|---|---|---|
| 第 0 章 | 00-はじめにと適合性.md | ドキュメント状態、範囲、RFC 2119 キーワード、適合性レベル、参照規範 |
| 第 1 章 | 01-アーキテクチャと役割.md | プロトコルの役割、信頼チェーン、外部インタフェース契約 |
| 第 2 章 | 02-データモデル.md | コアデータ構造(Authorization_Descriptor、Trusted_Ticket、Session、Verification_Key) |
| 第 3 章 | 03-オフライン認可プロトコル.md | Authorization_Descriptor 完全ライフサイクルプロトコルフロー |
| 第 4 章 | 04-オンラインチケットプロトコル.md | Trusted_Ticket 完全フローとデグレード |
| 第 5 章 | 05-セッション管理と生存検知.md | Session 状態機械、バインディング規則、ハートビート、二重判定、タイムアウト回収 |
| 第 6 章 | 06-制御権ハンドオーバープロトコル.md | Handover_Policy 3 種ポリシー、原子性保証、タイムアウトロールバック |
| 第 7 章 | 07-リソースアクセスモード.md | read/write/execute/configure セマンティクス、読み書きロックマトリクス |
| 第 8 章 | 08-暗号学と署名.md | アルゴリズム集、鍵形式、配布とローテーション |
| 第 9 章 | 09-エラーコードと適合性レベル.md | 標準エラーコード表、適合性宣言 |
| 第 10 章 | 10-セキュリティ考慮事項.md | 脅威モデル、既知のリスクと緩和 |
読み順の推奨
- 初読:第 0 章 → 第 1 章 → 第 2 章 → 第 3 章
- 端末実装:第 0–3 章 → 第 5、7 章 → 第 8、9 章
- 発行者実装:第 0–2 章 → 第 3、4 章 → 第 8 章
- iFay_Runtime 実装:第 0、1 章 → 第 5 章 → 第 9 章
- セキュリティ評価:第 10 章 + 関連章の横断読み
ドラフト状態
本ドラフトは議論段階にある。正式リリース前に:
- フィールド名、エラーコード、制約閾値が変更される可能性がある
- 章構成が再編される可能性がある
- 後方互換性は保証されない
議論が安定した後、本ディレクトリの内容は docs/ja/specification/2025-10-25/ として CAP プロトコルの初の正式バージョンとして公開される。
関連アセット
- アーキテクチャブループリント:
docs/ja/blueprint/ - Schema 定義(ドラフト):
schema/draft/ - 他言語版:本仕様は現在 zh-CN 版のみであり、正式リリース前に他の 8 言語へ翻訳される
