翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# ポリシーオーサリングガイド
<a name="policy-authoring-guide"></a>

このセクションは、Amazon Bedrock AgentCore のポリシーのサンプルポリシーの一元的なコレクションです。すべての例では、[リソース設定で説明されている単一のゲートウェイを例として使用します](example-policies-reference.md)。したがって、2 つの例を並べて読み、アクションの名前を変更したりスキーマを調整したりすることなく、1 つのポリシーエンジンで組み合わせることができます。

例は、ポリシーが一致する内容別にグループ化されています。[プリンシパルスコープポリシー](example-policies-principal.md)は、JWT ID または IAM 発信者の呼び出し元を決定します。[アクションとリソーススコープポリシー](example-policies-action-resource.md)は、呼び出されるアクション、ゲートウェイ、どの入力値を持つかによって決まります。このセクションは、2 つのポリシーが一緒に制約される[結合](example-policies-action-resource.md#example-policies-action-resource-combined)ポリシーと、1 つのエンジンのポリシーがどのように相互作用するかを決定するルールで終わります。

 [時間ベースのポリシー](example-policies-time-based.md)は、ウォールクロック時間から決定します。これらは通常の`when``context.system.now`句で読み取られるため、前述の 2 つのセクションと同様に、平凡な Cedar 内に留まります。

さらに 2 つのセクションでは、平坦な Cedar が表現できない条件について説明します。[ガードレールポリシーの例](example-policies-guardrails.md)は、コンテンツ安全スコアやプロンプト攻撃スコアなど、ガードレールが評価時に計算するシグナルから決定し、[一時ポリシーの例](example-policies-temporal.md)は、同じセッションの前半で既に発生したものから決定します。

これらはすべて 1 つの認可モデルを共有します。リクエストは、`permit`ポリシーが適用され、`forbid`ポリシーが上書きされない場合にのみ許可されるため、ポリシーのないポリシーエンジンはすべてを拒否します。また、1 つのポリシーでプリンシパル条件、入力条件、ガードレール信号、セッション履歴を組み合わせることもできます。

[Cedar](https://www.cedarpolicy.com/en) と互換性のあるオープンソースポリシー言語である [Dogwood](https://dogwood-policy.github.io/dogwood/index.html) の AgentCore で ポリシーのポリシーを作成します。Dogwood は、ガードレールと一時ポリシーが必要とする条件形式、`when guardrails { …​ }`および平坦な Cedar `when temporal { …​ }`が表現できない条件形式を追加します。有効な Cedar ポリシーはすべて有効な Dogwood ポリシーでもあるため、Cedar で既に作成したポリシーは変更なしで動作し続け、Cedar は完全にサポートされています。プリンシパルスコープ、アクションスコープ、時間ベースの例では、意図的に有効な Cedar でもあるコンストラクトのみを使用し、ガードレールと時間的な例では Dogwood 条件を使用します。

言語構文については、[Dogwood ポリシーウェブサイトの Dogwood 言語ガイド](https://dogwood-policy.github.io/dogwood/index.html)と [Cedar ポリシー言語](https://www.cedarpolicy.com/en)ウェブサイトを参照してください。AgentCore の Policy がゲートウェイのツールから生成するスキーマとそれに適用される制限については、[「制約とクォータ](policy-schema-constraints.md)」を参照してください。

**Topics**
+ [例のリソース設定](example-policies-reference.md)
+ [プリンシパルスコープポリシー](example-policies-principal.md)
+ [アクションおよびリソーススコープポリシー](example-policies-action-resource.md)
+ [時間ベースのポリシー](example-policies-time-based.md)
+ [ガードレールポリシーの例](example-policies-guardrails.md)
+ [一時ポリシーの例](example-policies-temporal.md)