AgentCore IAM アクセス許可の AgentCore ゲートウェイとポリシー

このガイドでは、Cedar ポリシーを使用したきめ細かな認可制御のために、Amazon Bedrock AgentCore Gateway を AgentCore のポリシーで使用するために必要な IAM アクセス許可を提供します。

概要

Amazon Bedrock AgentCore Gateway を AgentCore のポリシーと統合する場合、2 つの異なる IAM ロールが必要です。

どちらのロールも異なる目的を果たし、特定のアクセス許可を必要とします。ゲートウェイ実行ロールには Amazon Bedrock AgentCore Gateway オペレーションを実行するためのアクセス許可が必要ですが、リソース管理ロールには AgentCore リソースで Amazon Bedrock AgentCore Gateway とポリシーを設定および管理するためのアクセス許可が必要です。

ゲートウェイ実行ロール

ゲートウェイ実行ロールは、リクエストを処理するときに Amazon Bedrock AgentCore Gateway サービスによって引き受けられます。このロールには、次のアクセス許可が必要です。

信頼ポリシー

ゲートウェイ実行ロールは、bedrock-agentcore.amazonaws.comサービスプリンシパルを信頼する必要があります。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowBedrockAgentCoreAssumeRole",
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "123456789012"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:*"
        }
      }
    }
  ]
}

アクセス許可ポリシー

このポリシーは、Amazon Bedrock AgentCore Gateway に、AgentCore の Policy を通じて Cedar ポリシーを評価するために必要なアクセス許可を付与します AgentCore 。アクセス許可は、最小特権の原則に従って 2 つのステートメントに分割されます。

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PolicyEngineConfiguration",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:GetPolicyEngine"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/<policy-engine-id>"
      ]
    },
    {
      "Sid": "PolicyEngineAuthorization",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:AuthorizeAction",
        "bedrock-agentcore:PartiallyAuthorizeActions"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/<policy-engine-id>",
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gateway-id>"
      ]
    }
  ]
}

リソース管理ロール

リソース管理ロールは、管理者が AgentCore リソースで Amazon Bedrock AgentCore Gateway とポリシーを作成および管理するために使用します。このロールには、次のアクセス許可が必要です。

このロールはゲートウェイ実行ロールとは別に、AgentCore 設定で Amazon Bedrock AgentCore Gateway とポリシーを設定または変更する場合にのみ必要です。

アクセス許可ポリシー

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "GatewayManagement",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:CreateGateway",
        "bedrock-agentcore:UpdateGateway",
        "bedrock-agentcore:GetGateway",
        "bedrock-agentcore:DeleteGateway",
        "bedrock-agentcore:ListGateways",
        "bedrock-agentcore:InvokeGateway",
        "bedrock-agentcore:CreateGatewayTarget",
        "bedrock-agentcore:UpdateGatewayTarget",
        "bedrock-agentcore:GetGatewayTarget",
        "bedrock-agentcore:DeleteGatewayTarget",
        "bedrock-agentcore:ListGatewayTargets"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/*"
      ]
    },
    {
      "Sid": "PolicyEngineManagement",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:CreatePolicyEngine",
        "bedrock-agentcore:UpdatePolicyEngine",
        "bedrock-agentcore:GetPolicyEngine",
        "bedrock-agentcore:DeletePolicyEngine",
        "bedrock-agentcore:ListPolicyEngines"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/*"
      ]
    },
    {
      "Sid": "PolicyManagement",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:CreatePolicy",
        "bedrock-agentcore:UpdatePolicy",
        "bedrock-agentcore:GetPolicy",
        "bedrock-agentcore:DeletePolicy",
        "bedrock-agentcore:ListPolicies"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/*/policy/*"
      ]
    },
    {
      "Sid": "PolicyGeneration",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:StartPolicyGeneration",
        "bedrock-agentcore:GetPolicyGeneration",
        "bedrock-agentcore:ListPolicyGenerations",
        "bedrock-agentcore:ListPolicyGenerationAssets"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/*/policy-generation/*"
      ]
    },
    {
      "Sid": "IAMPassRole",
      "Effect": "Allow",
      "Action": [
        "iam:PassRole"
      ],
      "Resource": [
        "arn:aws:iam::123456789012:role/*BedrockAgentCore*"
      ],
      "Condition": {
        "StringEquals": {
          "iam:PassedToService": "bedrock-agentcore.amazonaws.com"
        }
      }
    },
    {
      "Sid": "IAMReadAccess",
      "Effect": "Allow",
      "Action": [
        "iam:GetRole",
        "iam:GetRolePolicy",
        "iam:ListAttachedRolePolicies",
        "iam:ListRolePolicies"
      ],
      "Resource": [
        "arn:aws:iam::123456789012:role/*"
      ]
    },
    {
      "Sid": "PolicyScopeManagement",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:ManageResourceScopedPolicy",
        "bedrock-agentcore:ManageAdminPolicy"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/*"
      ]
    }
  ]
}

ロールの更新が必要なタイミング

Amazon Bedrock AgentCore Gateway の作成方法に基づいて、Amazon Bedrock AgentCore Gateway 実行ロールに AgentCore アクセス許可のポリシーを追加する必要があるかどうかを確認します。

トラブルシューティング

このセクションでは、Amazon Bedrock AgentCore Gateway の IAM アクセス許可を AgentCore の ポリシーで設定する際の一般的な問題について説明します AgentCore 。

ポリシー評価中の InternalServerException

症状: ポリシーエンジンを既存のゲートウェイにアタッチInternalServerException - Policy evaluation failedすると、ゲートウェイは を返します。許可ポリシーが設定されていても、すべてのツール呼び出しはデフォルトで拒否されます。

根本原因: ゲートウェイ実行ロールに AgentCore アクセス許可に必要なポリシーがありません。これらのアクセス許可がないと、ゲートウェイはポリシー認可を実行できません。

解決策: ゲートウェイ実行ロールに次の 3 つのアクセス許可が含まれていることを確認します。

{
  "Effect": "Allow",
  "Action": [
    "bedrock-agentcore:PartiallyAuthorizeActions",
    "bedrock-agentcore:AuthorizeAction",
    "bedrock-agentcore:GetPolicyEngine"
  ],
  "Resource": [
    "arn:aws:bedrock-agentcore:REGION:ACCOUNT:policy-engine/*",
    "arn:aws:bedrock-agentcore:REGION:ACCOUNT:gateway/*"
  ]
}

CreatePolicy での「ゲートウェイを呼び出すためのアクセス許可が不十分」

症状: は CreatePolicyを返しますがpolicyId、ゲートウェイ実行ロールに AuthorizeAction、、 がある場合Insufficient permissions to call gateway with ID <gateway-id>でもPartiallyAuthorizeActions、ポリシーは CREATE_FAILEDで に移行しますGetPolicyEngine。

根本原因: ギャップは、ゲートウェイ実行ロールではなくCreatePolicy、 を呼び出すリソース管理ロールにあります。ポリシー検証は Gateway ( として認可bedrock-agentcore:InvokeGateway) を呼び出します。エラー名は Gateway ですが、修正はポリシー作成ロールにあります。

解決策: bedrock-agentcore:InvokeGateway (ゲートウェイ ARN の範囲) をリソース管理ロールに追加します。

{
  "Effect": "Allow",
  "Action": [
    "bedrock-agentcore:InvokeGateway"
  ],
  "Resource": [
    "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gateway-id>"
  ]
}

LOG_ONLY モードでのサイレント障害

症状: ポリシーエンジンは LOG_ONLY モードで動作しているように見えますが、適切なエラーメッセージなしでサイレントに失敗します。

根本原因: アクセスbedrock-agentcore:GetPolicyEngine許可がないと、ENFORCED モードに切り替えるときにのみ発生するサイレント障害が発生します。

解決策: テストbedrock-agentcore:GetPolicyEngineに LOG_ONLY モードを使用している場合でも、常にゲートウェイ実行ロールに を含めます。

ポリシーエンジンが見つかりませんエラー

症状: Amazon Bedrock AgentCore Gateway は、ポリシーエンジンを見つけられない、またはアクセスできないことを示すエラーを返します。

根本原因: ゲートウェイ実行ロールのポリシーが誤った ARN パターンを使用しているか、ポリシーエンジンリソースがありません。

解決策: ポリシーエンジンとゲートウェイの両方の ARNs がリソース配列に含まれていることを確認します。

"Resource": [
  "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/<policy-engine-id>",
  "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/<gateway-id>"
]

デバッグのヒント

例: 両方の IAM ロールの作成

次の例は、 CLI を使用して両方の必要な IAM AWS ロールを作成する方法を示しています。

ステップ 1: ゲートウェイ実行ロールを作成する

# Create the trust policy file
cat > gateway-trust-policy.json <<EOF
{
"Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "bedrock-agentcore.amazonaws.com"
      },
      "Action": "sts:AssumeRole",
      "Condition": {
        "StringEquals": {
          "aws:SourceAccount": "123456789012"
        },
        "ArnLike": {
          "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:*"
        }
      }
    }
  ]
}
EOF

# Create the IAM role
aws iam create-role \
  --role-name MyGatewayExecutionRole \
  --assume-role-policy-document file://gateway-trust-policy.json

ステップ 2: ゲートウェイ実行ロールにアクセス許可をアタッチする

# Create the permission policy file
cat > gateway-permissions.json <<EOF
{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "PolicyEngineConfiguration",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:GetPolicyEngine"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/*"
      ]
    },
    {
      "Sid": "PolicyEngineAuthorization",
      "Effect": "Allow",
      "Action": [
        "bedrock-agentcore:AuthorizeAction",
        "bedrock-agentcore:PartiallyAuthorizeActions"
      ],
      "Resource": [
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/*",
        "arn:aws:bedrock-agentcore:us-east-1:123456789012:gateway/*"
      ]
    }
  ]
}
EOF

# Attach the policy to the role
aws iam put-role-policy \
  --role-name MyGatewayExecutionRole \
  --policy-name GatewayPolicyEnginePermissions \
  --policy-document file://gateway-permissions.json

ステップ 3: 次のステップ

AgentCore で必要なポリシーのアクセス許可を使用して実行ロールを設定したら、ポリシーリソースの作成と設定に進みます。詳細なガイダンスについては、以下を参照してください。

ベストプラクティス