# Cedarの型検証で認可ルールの誤配信を止める設計

> Cedarの認可ポリシーは、Verified Permissionsの検証モードSTRICTとスキーマで変更時に誤記を拒否できます。適用範囲と限界、有効化の順序を整理します。

- Canonical: https://kuucorp.com/blog/cedar-schema-policy-change-validation-gate/
- Date: 2026-11-13
- Last modified: 2026-11-13
- Publisher: Kuu株式会社 (https://kuucorp.com)

---
エージェントがツールを呼ぶたびに、認可ポリシーが許可・拒否を決める。そのポリシーに属性名の typo が一つ混ざるだけで、意図した条件が働かないまま本番に配信される。実行時の判定ロジックがどれだけ堅牢でも、**ポリシーを書き換える瞬間の検査**がなければ誤配信は止まらない。

本記事は[エージェントガバナンス](/ai-governance/)の技術論として、Cedar のスキーマと検証モードを「ポリシー変更ゲート」として使う設計を扱う。実行時の判定側は[ポリシーエンジンによる実行時ガードレール](/blog/agent-runtime-policy-engine-guardrails/)、モデル選択は[認可モデル設計](/blog/agent-authorization-rbac-abac-rebac-design/)を参照。

## なぜポリシー変更時の検査が必要なのか

> 認可ポリシーの誤記は実行時まで表面化しにくいため、作成・更新の時点でスキーマに照らして拒否するゲートが有効です。

エージェント基盤では、ツールの追加や属性の改名に合わせてポリシーが頻繁に更新される。属性名の綴り違いや存在しないアクションの参照は、構文としては正しいので保存できてしまう。結果として条件が常に偽になり、意図した許可や拒否が効かない状態が静かに続く。

Cedar の検証は、この種の誤りを保存前に検出するための仕組みだ。公式ドキュメントによれば、検証はアクションがスキーマに存在するか、そのアクションが当該の principal・resource の型に適用できるかを確認する。

## スキーマには何を定義するのか

> スキーマはエンティティ型の構造と、リクエストで使えるアクションを宣言する定義であり、検証の基準になります。

Amazon Verified Permissions のスキーマは、エンティティ型（属性と型）とアクション（`appliesTo` で principal・resource の型を指定）を宣言する。AWS のドキュメントは、スキーマの利用を任意としつつ本番では強く推奨している。

エージェント基盤なら次のように対応づける。

- principal: エージェント、またはエージェントを動かすユーザー
- resource: ツール、データストア、MCP サーバーなどの対象
- action: ツールが公開する操作（読み取り・書き込み・送信など）
- 属性: 環境区分、データ分類など、ポリシーが条件に使う値

ツール追加のたびにアクションと属性をスキーマへ先に登録する運用にすると、ポリシー側の参照ミスがそのまま検証エラーになる。

## STRICT モードは何を拒否するのか

> STRICT を有効にすると、新規・更新された静的ポリシーとテンプレートが検証され、失敗したものは保存されません。

`ValidationSettings` の `mode` は `OFF` と `STRICT` の二値だ。STRICT は schema の存在を前提とし、検証に失敗した静的ポリシーとポリシーテンプレートを拒否する。スキーマが無い状態で STRICT にすると、すべての静的ポリシーとテンプレートが拒否される点に注意が必要だ。

Cedar の検証が捕捉する主な誤りは次のとおり。

- 未定義のエンティティ型・アクション・属性の参照
- `in` と `==` の取り違え、演算子の型不一致
- オプション属性への `has` ガードなしのアクセス
- 常に偽になる条件（警告として報告）

AWS の運用指針は、開発中は OFF、テストと本番では STRICT を推奨している。

## 有効化の順序と既存ポリシーの扱い

> STRICT は有効化後の作成・更新だけを検証し、既存ポリシーは再検証されません。有効化前に棚卸しが必要です。

AWS のドキュメントは、検証を有効にした後の新規作成・更新が対象で、**以前に作成したポリシーは再検証されない**と明記している。つまり STRICT を入れた時点で既存ポリシーの健全性は保証されない。手順は次の順が安全だ。

1. スキーマを PutSchema で登録する（アクション・属性を実態に合わせる）
2. 検証用の別ポリシーストアに既存ポリシーを投入し、STRICT で通るか確認する
3. 失敗したポリシーを修正してから、本番ストアを STRICT に切り替える
4. 以降のポリシー変更は CI から STRICT のストアに対して行う

スキーマ更新が既存ポリシーとの整合にどう影響するかは、今回確認した一次情報では記述を確認できていない。スキーマを変更する際は、変更後に全ポリシーを検証用ストアで再投入して確認する運用を勧める。

## 型検証で防げないことは何か

> 型検証はポリシーの記述ミスを止めますが、業務上の過剰許可や参照エンティティの欠落までは証明できません。

Cedar 公式は、検証が確認しない項目を明示している。

- 参照するエンティティが評価時のデータに存在するか
- `Long` 同士の加算によるオーバーフロー
- リクエストがスキーマに適合しているか（既定では未検査）

さらに、型として正しいポリシーが業務上正しいとは限らない。`permit` の範囲が広すぎても、型検証は通る。過剰許可の検出には、ポリシーの許可範囲を比較する分析や、許可・拒否を期待値として固定したテストケースの回帰実行を併用する。型検証は誤配信を減らす最初の関門であり、認可の正しさそのものの証明ではない。

### 規模別の留意点（SMB / エンタープライズ）

- **SMB**: ポリシーストアは1つで始め、スキーマと STRICT を最初から入れる。後から入れると既存ポリシーの棚卸しが発生する。導入と運用の伴走は [AIオペレーション支援](https://kuucorp.com/services/ai-ops/) で扱う。
- **エンタープライズ**: 検証用ストアと本番ストアを分け、ポリシー変更を CI のゲートに組み込む。チーム横断の変更承認と監査証跡まで含めた設計は [RDE](/services/rde/) の範囲だ。

## 参考

- [Amazon Verified Permissions: ポリシーストアのスキーマ](https://docs.aws.amazon.com/verifiedpermissions/latest/userguide/schema.html)
- [Amazon Verified Permissions: ポリシー検証モードの有効化](https://docs.aws.amazon.com/verifiedpermissions/latest/userguide/policy-validation-mode.html)
- [API リファレンス: ValidationSettings](https://docs.aws.amazon.com/verifiedpermissions/latest/apireference/API_ValidationSettings.html)
- [Cedar ポリシー言語リファレンス: Policy validation](https://docs.cedarpolicy.com/policies/validation.html)

## まとめ

> 認可ルールの誤配信は、スキーマと STRICT 検証を変更ゲートに置くことで、保存前に止められます。

スキーマでアクション・属性の型を固定し、STRICT で作成・更新を検査し、既存ポリシーは別途棚卸しする。この三点が最小構成だ。型検証で防げない過剰許可は、テストと許可範囲の分析で補う。

エージェントの認可ポリシーの変更管理を設計したい場合は、[Kuu株式会社のAIオペレーション支援](https://kuucorp.com/services/ai-ops/)にご相談ください。
