View a markdown version of this page

認可フロー - Amazon Bedrock AgentCore
リクエスト処理Cedar 認可リクエスト一時ポリシーのセッションコンテキストポリシーの評価

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

認可フロー

Amazon Bedrock AgentCore Gateway は、受信リクエストに対して Cedar ポリシーを評価します。このセクションでは、認可情報がリクエストからポリシー評価にどのように流れるかについて説明します。

リクエスト処理

Amazon Bedrock AgentCore Gateway は、各リクエストから 2 つの重要な情報を処理します。

  1. JWT トークン - ユーザーに関する OAuth クレームが含まれます。

    {
  "sub": "12345678-1234-1234-1234-123456789012",
  "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_Vg2efaoGO",
  "username": "refund-agent",
  "scope": "aws.cognito.signin.user.admin refund:write",
  "role": "admin",
  "department": "finance"
}

  2. MCP ツールコールリクエスト - 実際のツール呼び出し:

    {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "RefundTool___process_refund",
    "arguments": {
      "orderId": "12345",
      "amount": 450,
      "reason": "Defective product"
    }
  }
}

Cedar 認可リクエスト

Gateway は両方のソースから情報を抽出し、Cedar 認可リクエストを構築します。

認可リクエストを完了する: 

{
  "principal": "AgentCore::OAuthUser::\"12345678-1234-1234-1234-123456789012\"",
  "action": "AgentCore::Action::\"RefundTool___process_refund\"",
  "resource": "AgentCore::Gateway::\"arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/refund-gateway\"",
  "context": {
    "input": {
      "orderId": "12345",
      "amount": 450,
      "reason": "Defective product"
    }
  }
}

コンポーネント:

Principal

JWT トークンのサブクレームから作成:

AgentCore::OAuthUser::"12345678-1234-1234-1234-123456789012"
アクション

ツール名から抽出:

AgentCore::Action::"RefundTool___process_refund"
[リソース]

Gateway インスタンス:

AgentCore::Gateway::"arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/refund-gateway"
Context

ツール引数が含まれます。

{
  "input": {
    "orderId": "12345",
    "amount": 450,
    "reason": "Defective product"
  }
}

Entity Store - JWT クレームは、OAuthUser エンティティにタグとして保存されます。

{
  "uid": {
    "type": "AgentCore::OAuthUser",
    "id": "12345678-1234-1234-1234-123456789012"
  },
  "attrs": {
    "id": "12345678-1234-1234-1234-123456789012"
  },
  "tags": {
    "username": "refund-agent",
    "iss": "https://cognito-idp.us-east-1.amazonaws.com/us-east-1_Vg2efaoGO",
    "scope": "aws.cognito.signin.user.admin refund:write",
    "role": "admin",
    "department": "finance"
  }
}

一時ポリシーのセッションコンテキスト

x-amzn-bedrock-agentcore-policy-session-id ヘッダーが存在する場合、ゲートウェイはポリシーエンジンに渡された認可リクエストにセッションコンテキストを含めます。セッションコンテキストは、現在のセッションの累積アクション履歴を提供します。一時ポリシールールは、この履歴を使用して時間の経過とともに制約を評価します。

{
  "principal": "AgentCore::OAuthUser::\"12345678-1234-1234-1234-123456789012\"",
  "action": "AgentCore::Action::\"PaymentTool___transfer_funds\"",
  "resource": "AgentCore::Gateway::\"arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gateway\"",
  "context": {
    "input": {
      "amount": 500,
      "recipient": "account-789"
    }
  },
  "sessionId": "12345678-1234-1234-1234-123456789012"
}

sessionId フィールドは、現在のリクエストをセッション履歴にリンクします。ポリシーエンジンはセッション状態を解決し、蓄積されたアクションチェーンに対して該当するすべての時間ルールを評価します。

セッション ID の指定、セッションライフサイクル、およびマルチホップ呼び出し間での ID の伝播方法の詳細については、「ポリシーセッションと ID の伝播」を参照してください。

ポリシーの評価

Cedar は以下を評価します。

  1. プリンシパルチェック: プリンシパルは OAuthUser ですか? ✓ (一致)

  2. アクションチェック: アクションは RefundTool___process_refund ですか? ✓ (一致)

  3. リソースチェック: リソースは返金ゲートウェイですか? ✓ (一致)

  4. 条件チェック:

    • プリンシパルにユーザー名タグはありますか? ✓ (はい、JWT から)

    • username = "refund-agent"? ✓ (はい)

    • context.input.amount < 500 ですか? ✓ (450 < 500)

結果: 許可 - すべてのチェックに合格し、返金が承認されます。