

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 à un cluster Amazon DocumentDB depuis Studio 3T
<a name="studio3t"></a>

[Studio 3T](https://studio3t.com/) est une interface graphique et un IDE populaires pour les développeurs et les ingénieurs de données qui travaillent avec MongoDB. Il offre plusieurs fonctionnalités puissantes : des vues arborescentes, tabulaires et JSON de vos données, faciles import/export à utiliser en CSV, JSON, SQL et BSON/MongoDump, une option de requête flexible, une drag-and-drop interface utilisateur visuelle, un shell mongo intégré avec auto-complétion, un éditeur de pipeline d'agrégation et un support de requêtes SQL.

## Conditions préalables
<a name="prerequisites"></a>
+ Si vous ne possédez pas encore de cluster Amazon DocumentDB utilisant Amazon EC2 comme bastion/jump hôte, suivez les instructions pour [vous connecter à Amazon](https://docs.aws.amazon.com/documentdb/latest/developerguide/connect-ec2.html) EC2.
+ Si vous ne possédez pas Studio 3T, [téléchargez-le et installez-le](https://studio3t.com/download). 

## Connect avec Studio 3T
<a name="connect-studio3t"></a>

1. Choisissez **Connect** dans le coin supérieur gauche de la barre d'outils.  
![Interface Studio 3T affichant l'écran de bienvenue et l'option Connect surlignés dans le coin supérieur gauche.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-connect.png)

1. Choisissez **Nouvelle connexion** dans le coin supérieur gauche de la barre d'outils.  
![Interface Connection Manager avec l'option Nouvelle connexion surlignée dans le coin supérieur gauche.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-newconn.png)

1. Dans l'onglet **Serveur**, dans le champ **Serveur**, entrez les informations du point de terminaison du cluster.  
![Onglet Serveur dans l'interface Nouvelle connexion avec le champ de saisie Serveur surligné.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-endpoint.png)
**Note**  
Vous ne trouvez pas le point de terminaison de votre cluster ? Il vous suffit de suivre les étapes [indiquées ici](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-instance-endpoint-find.html).

1. Choisissez l'onglet **Authentification** et sélectionnez **Legacy** dans le menu déroulant du **mode d'authentification**.  
![Onglet Authentification de l'interface Nouvelle connexion avec le mode d'authentification existant sélectionné et les informations relatives au nom d'utilisateur, au mot de passe et à la base de données d'authentification fournies.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-auth.png)

1. Entrez votre nom d'utilisateur et vos informations d'identification dans les champs **Nom d'utilisateur** et **Mot de passe**.

1. Choisissez l'onglet **SSL** et cochez la case **Utiliser le protocole SSL pour vous connecter**.  
![onglet SSL dans l'interface Nouvelle connexion avec l'option Utiliser le protocole SSL pour se connecter sélectionnée.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-ssl.png)

1. Choisissez **Utiliser votre propre fichier racine CA**. Ajoutez ensuite le certificat Amazon DocumentDB (vous pouvez ignorer cette étape si le protocole SSL est désactivé sur votre cluster DocumentDB). Cochez la case pour autoriser les **noms d'hôtes non valides**.  
![onglet SSL dans l'interface Nouvelle connexion avec le fichier racine CA saisi et autorisant la sélection de noms d'hôtes non valides.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-ssl.png)
**Note**  
Vous n'avez pas le certificat ? Vous pouvez le télécharger à l'aide de la commande suivante :  
 `wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem ` 

1. Si vous vous connectez depuis une machine cliente extérieure à Amazon VPC, vous devez créer un tunnel SSH. Vous allez le faire dans l'onglet **SSH**.

   1. Cochez la case **Utiliser le tunnel SSH** et saisissez l'adresse SSH dans le champ Adresse **SSH.** Il s'agit du DNS public de votre instance (IPV4). Vous pouvez obtenir cette URL depuis votre console de [gestion Amazon EC2](https://console.aws.amazon.com/ec2).

   1. Entrez votre nom d'utilisateur. Il s'agit du nom d'utilisateur de votre instance Amazon EC2 

   1. Pour le **mode d'authentification SSH**, sélectionnez Clé **privée**. Dans le champ **Clé privée**, cliquez sur l'icône de recherche de fichiers pour localiser et choisir la clé privée de votre instance Amazon EC2. Il s'agit du fichier .pem (paire de clés) que vous avez enregistré lors de la création de votre instance dans la console Amazon EC2.

   1. Si vous utilisez un ordinateur Linux/macOS client, vous devrez peut-être modifier les autorisations de votre clé privée à l'aide de la commande suivante :

      `chmod 400 /fullPathToYourPemFile/<yourKey>.pem`  
![onglet SSH dans l'interface Nouvelle connexion avec les informations d'identification du tunnel SSH saisies.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-ssh.png)
**Note**  
Cette instance Amazon EC2 doit se trouver dans le même VPC Amazon et le même groupe de sécurité que votre cluster DocumentDB. Vous pouvez obtenir l'adresse SSH, le nom d'utilisateur et la clé privée depuis votre console de [gestion Amazon EC2.](https://console.aws.amazon.com/ec2)

1. Testez maintenant votre configuration en cliquant sur le bouton **Tester la connexion**.  
![Nouvelle interface de connexion avec le bouton Tester la connexion surligné dans le coin inférieur gauche.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-testbutton.png)

1. Une fenêtre de diagnostic doit charger une barre verte pour indiquer que le test a réussi. Choisissez maintenant **OK** pour fermer la fenêtre de diagnostic.  
![Fenêtre de diagnostic qui apparaît après un test de connexion réussi.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-testconn.png)

1. Choisissez **Enregistrer** pour enregistrer votre connexion en vue d'une utilisation future.  
![Nouvelle interface de connexion avec le bouton Enregistrer surligné.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-save.png)

1. Sélectionnez maintenant votre cluster et choisissez **Connect**.  
![Interface Connection Manager avec le bouton Connect surligné.](http://docs.aws.amazon.com/fr_fr/documentdb/latest/developerguide/images/studio3t/studio3t-finalconnect.png)

Félicitations \! Vous êtes désormais connecté avec succès à votre cluster Amazon DocumentDB via Studio 3T.