Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Connexion à des API privées dans EventBridge

Vous pouvez créer des connexions à des points de terminaison HTTPS privés, afin de fournir un accès réseau point à point sécurisé aux ressources des VPC ou sur site sans avoir à passer par l'Internet public. Par exemple, vous pouvez créer une connexion pour accéder à une HTTPS-based application située derrière un Amazon Elastic Load Balancer.

EventBridge crée des connexions vers des points de terminaison HTTPS privés en utilisant les configurations de ressources créées dans VPC Lattice. Une configuration de ressource est un objet logique qui identifie la ressource et indique comment et qui peut y accéder. Pour créer une connexion à une API privée dans EventBridge, vous devez spécifier la configuration des ressources pour l'API privée. Pour plus d'informations, consultez la section Configuration des ressources dans VPC Lattice dans le guide de l'utilisateur Amazon VPC Lattice.

EventBridge crée ensuite une association de ressources qui permet EventBridge d'accéder à l'API privée. Pour plus d'informations, consultez Gérer les associations de ressources dans le guide de l'utilisateur Amazon VPC Lattice.

Tout en EventBridge gérant l'association de ressources, il crée l'association à l'aide de vos informations d'identification, afin que vous conserviez une visibilité sur le fonctionnement de l'association de ressources.

Vous pouvez créer des connexions qui accèdent à des API privées dans d'autres AWS comptes. Pour de plus amples informations, veuillez consulter Cross-account API privées.

Autorisations de connexion à des API privées

L'exemple de politique suivant inclut les autorisations minimales nécessaires pour créer une connexion à une API privée.

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "vpc-lattice:CreateServiceNetworkResourceAssociation",
                "vpc-lattice:GetResourceConfiguration",
                "vpc-lattice:AssociateViaAWSService-EventsAndStates",
                "events:CreateConnection"
            ],
            "Resource": [
                "*"
            ],
            "Effect": "Allow"
        }
    ]
}

L'exemple de politique suivant inclut les autorisations minimales nécessaires pour mettre à jour une connexion à une API privée.

JSON

{
    "Version":"2012-10-17",
    "Statement": [
        {
            "Action": [
                "vpc-lattice:CreateServiceNetworkResourceAssociation",
                "vpc-lattice:GetResourceConfiguration",               
                "vpc-lattice:AssociateViaAWSService-EventsAndStates",
                "events:UpdateConnection"
            ],
            "Resource": [
                "*"
            ],
            "Effect": "Allow"
        }
    ]
}

Surveillance de la création de connexions aux API privées

Lorsque vous créez une connexion à une API privée, les journaux suivants sont générés :

Dans le compte dans lequel la connexion a été créée, AWS CloudTrail enregistre un CreateServiceNetworkResourceAssociation événement.

Dans ce journal, sourceIPAddressuserAgent, et serviceNetworkIdentifier sont définis sur le principal du EventBridge service,events.amazonaws.com.

{
  "eventTime": "2024-11-21T00:00:00Z",
  "eventSource": "vpc-lattice.amazonaws.com",
  "eventName": "CreateServiceNetworkResourceAssociation",
  "awsRegion": "region",
  "sourceIPAddress": "events.amazonaws.com", 
  "userAgent": "events.amazonaws.com",
  "requestParameters": {
    "x-amzn-vpc-lattice-association-source-arn": "***",
    "x-amzn-vpc-lattice-service-network-identifier": "***",
    "clientToken": "token",
    "serviceNetworkIdentifier": "events.amazonaws.com",
    "resourceConfigurationIdentifier": "arn:partition:vpc-lattice:region:account-id:resourceconfiguration/resource-configuration-id",
    "tags": {
        "ManagedByServiceAWSEventBridge": "account-id:connection-name"
    }
}

Dans le compte qui contient l'API privée, AWS CloudTrail enregistre un CreateServiceNetworkResourceAssociationBySharee événement.

Ce journal inclut :

{
  "eventTime": "2024-11-21T06:31:42Z",
  "eventSource": "vpc-lattice.amazonaws.com",
  "eventName": "CreateServiceNetworkResourceAssociationBySharee",
  "awsRegion": "region",
  "sourceIPAddress": "vpc-lattice.amazonaws.com",
  "userAgent": "user-agent",
  "additionalEventData": {
      "callerAccountId": "consumer-account-id"
  },
  "resources": [
      {
          "accountId": "provider-account-id",
          "type": "AWS::VpcLattice::ServiceNetworkResourceAssociation",
          "ARN": "resource-configuration-arn"
      }
  ]
}

Dans le cas de connexions entre comptes à des API privées, le compte contenant la connexion ne recevra AWS CloudTrail aucun journal VPC Lattice pour l'invocation de l'API privée.

Gestion des associations de ressources du réseau de service pour les connexions

Lorsque vous spécifiez la configuration des ressources VPC Lattice pour l'API privée à laquelle vous souhaitez vous connecter, EventBridge activez la connexion en créant une association de ressources entre la configuration des ressources VPC Lattice et un réseau de service VPC Lattice appartenant au service. EventBridge Tout en EventBridge gérant l'association de ressources, il crée l'association à l'aide de vos informations d'identification, afin que vous conserviez une visibilité sur l'association de ressources. Cela signifie que vous pouvez répertorier et décrire les associations de ressources.

Utilisez describe-connection pour renvoyer une description de connexion qui inclut les Amazon Resource Names (ARN) de la configuration des ressources et de l'association des ressources.

Vous ne pouvez pas supprimer les associations de ressources créées par EventBridge. Si vous supprimez une connexion, toutes les associations EventBridge de ressources correspondantes sont supprimées.

Pour plus d'informations, consultez Gérer les associations de ressources dans le guide de l'utilisateur Amazon VPC Lattice.

Connexion à des API privées sur site

En accédant aux ressources VPC via un AWS PrivateLink VPC Lattice, vous pouvez vous connecter à des API privées sur site. Pour ce faire, vous devez configurer une route réseau entre votre VPC et votre environnement sur site. Par exemple, vous pouvez utiliser AWS Direct Connectou AWS Site-to-Site VPNétablir un tel itinéraire.