Amazon Bedrock AgentCore のリソースベースのポリシー

Amazon Bedrock AgentCore のリソースベースのポリシーを使用すると、どのプリンシパル (AWS アカウント、IAM ユーザー、または IAM ロール) が Amazon Bedrock AgentCore リソース (現在、ランタイム、ゲートウェイ、メモリでサポートされています) を呼び出して管理できるかを制御できます。IAM スタイルのポリシーをリソースに直接アタッチして、ランタイムセッションの開始、ゲートウェイの呼び出し、メモリへのアクセス、またはその他の管理および呼び出しアクションを実行できるユーザーに関するルールを定義できます。

リソースベースのポリシーは、アイデンティティベースの IAM ポリシーと組み合わせて動作し、Amazon Bedrock AgentCore リソースのアクセスコントロールを提供します。ID ベースのポリシーは IAM ID にアタッチされ、実行できるアクションを指定しますが、リソースベースのポリシーはリソースに直接アタッチされ、それらにアクセスできるユーザーを指定します。

サポートされているリソース

Amazon Bedrock AgentCore は、次のリソースのリソースベースのポリシーをサポートしています。

リソースベースのポリシーの仕組み

アイデンティティベースのポリシーとリソースベースのポリシー

ポリシーの評価

Amazon Bedrock AgentCore リソースに対してリクエストが行われると、 はアイデンティティベースのポリシーとリソースベースのポリシーの両方 AWS を評価します。次の表は、さまざまなポリシーの組み合わせがアクセスにどのように影響するかを示しています。

主な原則:

エージェントランタイムとエンドポイントの階層認可

エージェントエンドポイントは、エージェントのランタイムの特定のバージョンへのアドレス可能なアクセスポイントです。各エンドポイントはランタイム設定の特定のバージョンを指し、DEFAULT エンドポイントは自動的に最新バージョンにルーティングされます。InvokeAgentRuntime や などのランタイム API InvokeAgentRuntimeCommand オペレーションを承認すると、 はエージェントランタイムと呼び出されるエージェントエンドポイントの両方について、アイデンティティベースのポリシーとリソースベースのポリシーの両方 AWS を評価します。

リクエストを承認するには、次の条件を満たす必要があります。

例: クロスアカウントアクセスを許可するには、両方のリソースにポリシーが必要です。

// Policy for Agent Runtime (attached to
// arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID)
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/CrossAccountRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

// Policy for Agent Endpoint (attached to
// arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID/endpoint/ENDPOINTID)
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/CrossAccountRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID/endpoint/ENDPOINTID"
        }
    ]
}

認証タイプの考慮事項

リソースベースのポリシーの記述方法は、エージェントランタイムまたはゲートウェイ用に設定された認証タイプによって異なります。

ポリシーの構造

リソースベースのポリシーは、次の構造を持つ JSON ドキュメントです。

{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "StatementId",
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::account-id:role/role-name"
            },
            "Action": "bedrock-agentcore:ActionName",
            "Resource": "arn:aws:bedrock-agentcore:region:account-id:resource-type/resource-id",
            "Condition": {
                "ConditionOperator": {
                    "ConditionKey": "ConditionValue"
                }
            }
        }
    ]
}

サポートされているアクション

エージェントランタイムアクション

ゲートウェイアクション

メモリアクション

条件キー

条件キーを使用して、ポリシーのアクセスコントロールをさらに絞り込むことができます。使用可能な条件キーの完全なリストについては、「Bedrock AgentCore 条件キー」とAWS 「グローバル条件コンテキストキー」を参照してください。

一般的なユースケースと例

このセクションでは、一般的なシナリオのリソースベースのポリシーの実用的な例を示します。各例の Resourceフィールドには、ポリシーがアタッチされているリソースの正確な ARN が含まれている必要があります。サンプル ARNs を実際のリソース ARNs。

別の AWS アカウントでロールを許可する

別の AWS アカウントの特定のロールへの API アクセスを付与します。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": [
                    "arn:aws:iam::123456789012:role/DeveloperRole",
                    "arn:aws:iam::123456789012:role/AdminRole"
                ]
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

送信元 IP アドレスに基づいてトラフィックを拒否する

特定の IP アドレス範囲からの受信トラフィックをブロックします。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        },
        {
            "Effect": "Deny",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "IpAddress": {
                    "aws:SourceIp": [
                        "192.0.2.0/24",
                        "198.51.100.0/24"
                    ]
                }
            }
        }
    ]
}

特定の VPC からのトラフィックのみを許可する

特定の VPC からのリクエストへのアクセスを制限します。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        },
        {
            "Effect": "Deny",
            "Principal": {
                "AWS": "arn:aws:iam::123456789012:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringNotEquals": {
                    "aws:SourceVpc": "vpc-1a2b3c4d"
                }
            }
        }
    ]
}

VPC 制限による OAuth 認証

エージェントランタイムまたはゲートウェイが OAuth 認証で設定されている場合は、ワイルドカードプリンシパルを使用する必要があります。この例では、OAuth 認証リクエストを特定の VPC に制限します。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "AllowOAuthFromVPC",
            "Effect": "Allow",
            "Principal": "*",
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringEquals": {
                    "aws:SourceVpc": "vpc-1a2b3c4d"
                }
            }
        }
    ]
}

リソースポリシーの管理

次のいずれかの方法を選択します。

セキュリティのベストプラクティス

最小特権アクセス許可を適用する

ユースケースに必要な最小限のアクセス許可のみを付与します。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::111122223333:role/ApplicationRole"
            },
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID"
        }
    ]
}

混乱した代理の防止

AWS サービスへのアクセスを許可するときは、常に条件キーを使用してください。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:gateway/GATEWAYID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "lambda.amazonaws.com"
            },
            "Action": "bedrock-agentcore:InvokeGateway",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:gateway/GATEWAYID",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "111122223333"
                },
                "ArnEquals": {
                    "aws:SourceArn": "arn:aws:lambda:us-west-2:111122223333:function/SpecificFunction"
                }
            }
        }
    ]
}

重要なコントロールに明示的な拒否を使用する

セキュリティクリティカルな制限には、明示的な拒否ステートメントを使用します。

// Policy attached to arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID
{
"Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "DenyAllExceptVPC",
            "Effect": "Deny",
            "Principal": "*",
            "Action": "bedrock-agentcore:InvokeAgentRuntime",
            "Resource": "arn:aws:bedrock-agentcore:us-west-2:111122223333:runtime/AGENTID",
            "Condition": {
                "StringNotEquals": {
                    "aws:SourceVpc": "vpc-12345678"
                },
                "Bool": {
                    "aws:ViaAWSService": "false"
                }
            }
        }
    ]
}

トラブルシューティング

アクセス拒否エラー

「アクセスが拒否されました」というエラーが表示された場合:

ポリシー検証エラー

一般的なポリシー検証エラー: