重要な概念
Amazon Bedrock AgentCore でポリシーを使用する前に、AI エージェントにポリシーベースのガバナンスを提供するために連携する主要な概念とコンポーネントを理解することが重要です。
ゲートウェイ
Amazon Bedrock AgentCore Gateway は、MCP サーバーに接続し、APIs と Lambda を MCP 互換ツールに変換するエンドポイントを提供し、エージェントがツールとやり取りするための単一のアクセスポイントを提供します。ゲートウェイは複数のターゲットを持つことができ、それぞれが異なるツールまたはツールのセットを表します。
ゲートウェイターゲット
ターゲットは、ゲートウェイがエージェントにツールとして提供する APIs または Lambda 関数を定義します。ターゲットは、Lambda 関数、OpenAPI 仕様、Smithy モデル、またはその他のツール定義です。
プリンシパルタイプ
Cedar ポリシーは、プリンシパルを使用して認可リクエストを行うエンティティを表します。AgentCore のポリシーは、AgentCore Gateway が認証用にどのように設定されているかに応じて、2 つのプリンシパルタイプをサポートします。
-
AgentCore::OAuthUser - OAuth 認証ユーザーを表します。AgentCore Gateway が OAuth 認可を使用する場合、プリンシパルは JWT トークンの
subクレームから作成されます。OAuth プリンシパルは、ユーザー名、スコープ、ロールなどの JWT クレームを含むタグをサポートします。 -
AgentCore::IamEntity - IAM 認証された発信者を表します。AgentCore Gateway が AWS_IAM 認可を使用する場合、プリンシパルは発信者の IAM ID から作成されます。IAM プリンシパルには、IAM ARN (引き受けたロール
arn:aws:sts::<account>:assumed-role/<role-name>の形式:) を含むid属性があり、安定したprincipal ==マッチングを可能にします。詳細については、「ポリシー条件」を参照してください。
シダー
Cedar
Cedar ポリシー
Cedar ポリシーは、ゲートウェイツールへのアクセスを許可または禁止する宣言ステートメントです。各ポリシーは、どの条件のどのリソース (ゲートウェイ) に対してどのアクション (ツール呼び出し) をどのユーザー (プリンシパル) が実行できるかを指定します。ポリシーは、ツール呼び出しリクエストごとに評価されます。
ポリシーエンジン
ポリシーエンジンは、Cedar ポリシーを保存および評価する AgentCore のポリシーのコアコンポーネントです。ポリシーを作成すると、ポリシースコープがリクエストと一致する限り、エンジンに関連付けられているすべてのゲートウェイに適用されます。ツールの呼び出しごとに、ポリシーエンジンは該当するすべてのポリシーをリクエストに対して評価し、アクセスを許可するか拒否するかを決定します。エンジンは default-deny および forbid-wins セマンティクスを自動的に適用します。
Cedar スキーマ
Cedar スキーマは、ポリシー検証のエンティティ、アクション、コンテキストの構造を定義します。ポリシーエンジンは、ゲートウェイのツール定義からスキーマを自動的に生成し、各ツールをアクションにマッピングして、予想される入力パラメータを定義します。スキーマにより、作成時にポリシーが検証され、デプロイ前にエラーがキャッチされます。
Cedar 検証
Cedar 検証は、ポリシーが構文的に正しく、スキーマに準拠していることを確認します。ポリシーをゲートウェイに関連付けると、ポリシーエンジンは自動生成されたスキーマに対してポリシーを検証して、有効なアクションを参照し、正しいデータ型を使用し、定義されたコンテキストフィールドにのみアクセスすることを確認します。検証は、ポリシーがデプロイされる前にエラーをキャッチし、ランタイム認可の失敗を防ぎます。
Cedar 分析
Cedar 分析では、自動推論を使用してポリシーを調べ、潜在的な問題を検出します。AgentCore のポリシーは、自動推論を使用して、常に を許可する (アクセスを制限する条件がない) または常に拒否する (例外のないポリシーを禁止する) ポリシーを識別し、ポリシーが過度に寛容または不必要に制限されるのではなく、意図したアクセスコントロールを実装できるようにします。
ポリシーオーサリングサービス
ポリシー作成サービスは、自然言語認可要件を Cedar ポリシーに自動的に変換します。自然言語ポリシーを送信すると、サービスは構文的に正しい Cedar コードを生成し、ゲートウェイスキーマと照合して検証し、自動分析を実行して潜在的な問題を検出します。これにより、生成されたすべてのポリシーが有効になり、デプロイ前に過度に寛容または制限的なルールを特定するのに役立ちます。
