Amazon Bedrock AgentCore Gateway で IAM 条件キーを使用する

Amazon Bedrock AgentCore 固有の条件キーを使用して、組織内のゲートウェイとゲートウェイターゲットの作成方法と設定方法を制御します。これらの条件キーは、コントロールプレーンオペレーションに適用されます。これらは、組織のセキュリティ要件を適用するためにサービスコントロールポリシー (SCPsで特に役立ちます。

例えば、以下のことが可能です:

ゲートウェイ条件キー

CreateGateway および UpdateGatewayオペレーションには、次の条件キーが適用されます。

ゲートウェイターゲット条件キー

CreateGatewayTarget および UpdateGatewayTargetオペレーションには、次の条件キーが適用されます。

ポリシーの例

次の例は、IAM ポリシーと SCPs で条件キーを使用して、ゲートウェイ設定に組織制御を適用する方法を示しています。

ゲートウェイに特定の ID プロバイダーの使用を要求する

次の SCP を使用して、ゲートウェイが組織の承認済み ID プロバイダー検出 URL を使用しない場合に、ゲートウェイの作成または更新を拒否します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceGatewayIdP",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:UpdateGateway"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "bedrock-agentcore:DiscoveryUrl": "https://login.example.com/.well-known/openid-configuration"
                }
            }
        }
    ]
}

ターゲットの認証情報プロバイダータイプを制限する

次の SCP を使用して、ゲートウェイターゲットを承認された認証情報プロバイダータイプに制限します。この例では、ゲートウェイの IAM ロールまたは発信者の IAM 認証情報のみを使用するようにゲートウェイターゲットを制限します。ターゲットは、外部管理の API キーまたは OAuth トークンを使用できません。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "RestrictTargetCredentialTypes",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "StringNotEquals": {
                    "bedrock-agentcore:CredentialProviderType": [
                        "GATEWAY_IAM_ROLE",
                        "CALLER_IAM_CREDENTIALS"
                    ]
                }
            }
        }
    ]
}

作成できる MCP ターゲットのタイプを制限する

次のポリシーを使用して、特定の設定タイプを使用する MCP ターゲットの作成を拒否します。この例では、ターゲットが直接 MCP サーバー URLsを使用することを防ぎます。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "DenyDirectMcpServerTargets",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "StringEquals": {
                    "bedrock-agentcore:McpTargetConfigurationType": "mcpServer"
                }
            }
        }
    ]
}

ターゲットにプライベートエンドポイントの使用を要求する

プライベートエンドポイントタイプを指定しないターゲットの作成を拒否するには、次の SCP を使用します。これにより、すべてのターゲットトラフィックがプライベートネットワーク内に留まります。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforcePrivateEndpoints",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "bedrock-agentcore:PrivateEndpointType": "true"
                }
            }
        }
    ]
}

ゲートウェイにカスタマーマネージド KMS キーの使用を要求する

この SCP を使用して、すべてのゲートウェイがサービスデフォルトではなくカスタマーマネージド KMS キーを暗号化に使用することを要求します。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceCustomerManagedKey",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGateway",
                "bedrock-agentcore:UpdateGateway"
            ],
            "Resource": "*",
            "Condition": {
                "Null": {
                    "bedrock-agentcore:KmsKeyArn": "true"
                }
            }
        }
    ]
}

ゲートウェイターゲットに承認されたサブネットを強制する

次のポリシーを使用して、ゲートウェイターゲットを承認されたサブネットに制限します。詳細については、AgentCore VPC 設定で IAM 条件キーを使用する」を参照してください。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "EnforceApprovedSubnets",
            "Effect": "Deny",
            "Action": [
                "bedrock-agentcore:CreateGatewayTarget",
                "bedrock-agentcore:UpdateGatewayTarget"
            ],
            "Resource": "*",
            "Condition": {
                "ForAnyValue:StringNotEquals": {
                    "bedrock-agentcore:subnets": [
                        "subnet-0123456789abcdef0",
                        "subnet-0123456789abcdef1"
                    ]
                }
            }
        }
    ]
}