Utiliser les clés de condition IAM avec Amazon Bedrock Gateway AgentCore

Utilisez les clés de AgentCore-specific condition Amazon Bedrock pour contrôler la façon dont vous créez et configurez les passerelles et les cibles de passerelle dans votre organisation. Ces clés de condition s'appliquent aux opérations du plan de contrôle. Ils sont particulièrement utiles dans les politiques de contrôle des services (SCP) pour appliquer les exigences de sécurité de l'organisation.

Par exemple, vous pouvez effectuer les actions suivantes :

Clés d'état de la passerelle

Les clés de condition suivantes s'appliquent aux UpdateGateway opérations CreateGateway et.

Clés de condition cible de la passerelle

Les clés de condition suivantes s'appliquent aux UpdateGatewayTarget opérations CreateGatewayTarget et.

Exemples de politiques

Les exemples suivants montrent comment utiliser les clés de condition dans les politiques IAM et les SCP pour appliquer les contrôles organisationnels sur la configuration de la passerelle.

Exiger que les passerelles utilisent un fournisseur d'identité spécifique

Utilisez le SCP suivant pour refuser la création ou la mise à jour d'une passerelle lorsque celle-ci n'utilise pas l'URL de découverte du fournisseur d'identité approuvé par votre organisation.

{
    "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"
                }
            }
        }
    ]
}

Restreindre les types de fournisseurs d'informations d'identification pour les cibles

Utilisez le SCP suivant pour limiter les cibles de passerelle aux types de fournisseurs d'informations d'identification approuvés. Dans cet exemple, vous limitez les cibles de la passerelle à n'utiliser que le rôle IAM de la passerelle ou les informations d'identification IAM de l'appelant. Les cibles ne peuvent pas utiliser de clés d'API ou de jetons OAuth gérés en externe.

{
    "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"
                    ]
                }
            }
        }
    ]
}

Restreindre les types de cibles MCP qui peuvent être créées

Utilisez la politique suivante pour refuser la création de cibles MCP utilisant certains types de configuration. Cet exemple empêche les cibles d'utiliser des URL de serveur MCP directes.

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

Exiger que les cibles utilisent des points de terminaison privés

Utilisez le SCP suivant pour refuser la création de cibles qui ne spécifient pas de type de point de terminaison privé. Cela garantit que tout le trafic cible reste sur les réseaux privés.

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

Exiger que les passerelles utilisent une clé KMS gérée par le client

Utilisez ce SCP pour exiger que toutes les passerelles utilisent une clé KMS gérée par le client pour le chiffrement au lieu de la clé par défaut du service.

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

Appliquer les sous-réseaux approuvés pour les cibles de passerelle

Utilisez la politique suivante pour limiter les cibles de passerelle aux sous-réseaux approuvés. Pour plus d'informations, consultez Utiliser les clés de condition IAM avec les paramètres AgentCore VPC.

{
    "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"
                    ]
                }
            }
        }
    ]
}