

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.

# Création de connexions pour les cibles d'API dans EventBridge
<a name="eb-target-connection-create"></a>

Les étapes suivantes vous expliquent comment créer une connexion à un point de terminaison HTTPS.

**Topics**
+ [Définissez la connexion](#eb-target-connection-create-define)
+ [Configuration du point de terminaison d'invocation](#eb-target-connection-create-invocation)
+ [Configuration de l'autorisation du point de terminaison](#eb-target-connection-create-auth)
+ [Configuration du chiffrement](#eb-target-connection-create-cmkms)

## Définissez la connexion
<a name="eb-target-connection-create-define"></a>

1. Ouvrez la [EventBridge console](https://console.aws.amazon.com/events).

1. Dans le volet de navigation de gauche, sous **Intégration**, choisissez **Connections**.

1. Choisissez **Créer une connexion**.

1. Sur la page **Créer une connexion**, entrez un **nom de connexion** et une **description**.

## Configuration du point de terminaison d'invocation
<a name="eb-target-connection-create-invocation"></a>

Ensuite, utilisez la section **Configurer l'invocation** pour spécifier le type d'API que vous souhaitez appeler par la connexion. EventBridge les connexions prennent en charge les API publiques et privées.
+ Pour le **type d'API**, choisissez si le point de terminaison est une API publique ou privée.

  Si vous choisissez une API privée, spécifiez la configuration des ressources VPC Lattice à utiliser pour vous y connecter. 

  Sous **API privée** : 
  + Pour utiliser une configuration de ressources VPC Lattice existante, choisissez-en une dans le menu déroulant.
  + Pour créer une nouvelle configuration de ressources VPC Lattice, choisissez **New** Resource configuration.

    Vous êtes redirigé vers la console de service Amazon VPC Lattice, où vous pouvez créer une nouvelle configuration. Pour plus d'informations, consultez [Créer une configuration de ressources dans le guide de l'utilisateur d'](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html)Amazon *VPC* Lattice.

## Configuration de l'autorisation du point de terminaison
<a name="eb-target-connection-create-auth"></a>

Spécifiez ensuite les paramètres d'autorisation à utiliser pour accéder au point de terminaison. 

EventBridge prend en charge les méthodes d'authentification de base, les informations d'identification du client OAuth et les méthodes d'authentification par clé d'API.

1. Pour **Configurer l'autorisation**, choisissez le type de point de terminaison auquel vous souhaitez vous connecter.

------
#### [ Custom endpoint ]

   Si la connexion est établie avec un point de terminaison autre qu'un point de terminaison partenaire, choisissez **Configuration personnalisée**.

   1. Pour **Type d'autorisation**, sélectionnez la méthode d'autorisation pour la connexion à utiliser.

   1. Spécifiez les détails de configuration de l'autorisation pour la méthode d'autorisation que vous avez choisie :
      + **Base**

        Entrez le **nom d'utilisateur** et le **mot de passe** à utiliser pour autoriser le point de terminaison HTTPS.
      + **Informations d'identification du client OAuth**

        1. Pour le point de **terminaison d'autorisation OAuth**, choisissez si le point de terminaison à utiliser pour l'autorisation de connexion est un point de terminaison public ou privé.

           Si vous choisissez **Privé**, spécifiez la configuration des **ressources du point de terminaison OAuth privé** :
           + Pour utiliser une configuration de ressource existante, choisissez-en une dans le menu déroulant.
           + Pour créer une nouvelle configuration de ressources, choisissez **Nouvelle configuration de ressources**.

             Vous êtes redirigé vers la console de service Amazon VPC Lattice ; où vous pouvez créer une nouvelle configuration. Pour plus d'informations, consultez [Créer une configuration de ressources dans le guide de l'utilisateur d'](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html)Amazon *VPC* Lattice.

        1. Spécifiez les informations d'autorisation suivantes :
           + Point final d'autorisation
           + Méthode HTTP
           + ID client
           + Secret client

        1. Sous **Paramètres HTTP OAuth, ajoutez tous les paramètres** supplémentaires à inclure pour l'autorisation avec le point de terminaison d'autorisation. 

           Pour ce faire :
           + Sélectionnez un **paramètre** dans la liste déroulante.
           + Saisissez une **Key** (Clé) et une **Value** (Valeur).

           Pour inclure un paramètre supplémentaire, choisissez **Ajouter un paramètre**.
      + **Clé d'API**

        Entrez le **nom de la clé d'API** et **la valeur** associée à utiliser pour l'autorisation de la clé d'API.

------
#### [ Partner endpoint ]

   Si la connexion est établie avec un point de terminaison partenaire, choisissez **Utiliser un modèle partenaire**. Pour obtenir la liste des points de terminaison partenaires disponibles, consultez[Partenaires de destination d’API](eb-api-destination-partners.md).

   1. Dans **Destination du partenaire**, sélectionnez le partenaire auquel vous souhaitez vous connecter.

      Sous **Type d'autorisation**, EventBridge active les méthodes d'autorisation disponibles pour le partenaire.

   1. Pour **Type d'autorisation**, sélectionnez la méthode d'autorisation pour la connexion à utiliser.

   1. Spécifiez les détails de configuration de l'autorisation pour la méthode d'autorisation que vous avez choisie :
      + **Base**

        Entrez le **nom d'utilisateur** et le **mot de passe** à utiliser pour autoriser le point de terminaison HTTP.
      + **Informations d'identification du client OAuth**

        1. Pour le point de **terminaison d'autorisation OAuth**, choisissez si le point de terminaison à utiliser pour l'autorisation de connexion est un point de terminaison public ou privé (VPC).

           Si vous choisissez **Privé**, spécifiez la configuration des **ressources du point de terminaison OAuth privé** :
           + Pour utiliser une configuration de ressources VPC Lattice existante, choisissez-en une dans le menu déroulant.
           + Pour créer une nouvelle configuration de ressources VPC Lattice, choisissez **Nouvelle** configuration de ressources.

             Vous êtes redirigé vers la console de service Amazon VPC Lattice, où vous pouvez créer une nouvelle configuration. Pour plus d'informations, consultez [Créer une configuration de ressources dans le guide de l'utilisateur d'](https://docs.aws.amazon.com/vpc-lattice/latest/ug/create-resource-configuration.html)Amazon *VPC* Lattice.

        1. Spécifiez les informations d'autorisation suivantes :
           + Point final d'autorisation
           + Méthode HTTPS
           + ID client
           + Secret client

        1. Sous **Paramètres HTTP OAuth, ajoutez tous les paramètres** supplémentaires à inclure pour l'autorisation avec le point de terminaison d'autorisation. 

           Pour ce faire :
           + Sélectionnez un **paramètre** dans la liste déroulante.
           + Saisissez une **Key** (Clé) et une **Value** (Valeur).

           Pour inclure un paramètre supplémentaire, choisissez **Ajouter un paramètre**.
      + **Clé d'API**

        Entrez le **nom de la clé d'API** et **la valeur** associée à utiliser pour l'autorisation de la clé d'API.

------

1. Sous **Paramètres Http d’appel**, ajoutez tous les paramètres supplémentaires à inclure dans la demande d’autorisation. 

   Pour ajouter un paramètre :

   1. Sélectionnez un **paramètre** dans la liste déroulante

   1. Entrez une **clé** et une **valeur**

   Pour inclure un paramètre supplémentaire, choisissez **Ajouter un paramètre**.

## Configuration du chiffrement
<a name="eb-target-connection-create-cmkms"></a>

Enfin, spécifiez le type de clé KMS que vous EventBridge souhaitez utiliser pour chiffrer et déchiffrer les paramètres d'autorisation dans lesquels elle est stockée en tant que secret. AWS Secrets Manager Par défaut, EventBridge utilise unClé détenue par AWS.

Pour de plus amples informations, veuillez consulter [Chiffrement des connexions](encryption-connections.md).

1. Choisissez la KMS key forme EventBridge à utiliser lors du chiffrement du secret de connexion.
   + Choisissez **Utiliser Clé détenue par AWS** pour chiffrer EventBridge le secret à l'aide d'unClé détenue par AWS.

     Il s'Clé détenue par AWSagit d'un compte KMS key qui EventBridge possède et gère pour une utilisation dans plusieurs AWS comptes. En général, à moins que vous ne soyez obligé d'auditer ou de contrôler la clé de chiffrement qui protège vos ressources, une Clé détenue par AWS est un bon choix. 

     Il s’agit de l’option par défaut.
   + Choisissez **Utiliser clé gérée par le client** pour chiffrer le secret EventBridge à l'aide de celui clé gérée par le client que vous spécifiez ou créez.

     Clés gérées par le clientse trouvent KMS keys dans le AWS compte que vous créez, détenez et gérez. Vous en avez le plein contrôleKMS keys.

     1. Spécifiez un existant clé gérée par le client ou choisissez **Créer un nouveau KMS key**.

       EventBridgeaffiche le statut de la clé et tous les alias de clé associés à la clé spécifiéeclé gérée par le client.

1. Choisissez **Create Connection** (Créer une connexion).
**Note**  
Pour les connexions destinées à des points de terminaison privés, EventBridge crée l'association de ressources nécessaire lors de la création de la connexion. Cela peut prendre jusqu'à 90 secondes.