Connecting to an Amazon DocumentDB Cluster from Studio 3T

    • If you don’t already have an Amazon DocumentDB cluster running on Amazon EC2, follow the instructions on how to Connect with Amazon EC2.

    • If you don’t have Studio 3T, .

    Connect with Studio 3T

    1. Choose Connect in the top left corner of the toolbar.

    2. Choose New Connection in the top left corner of the toolbar.

      Connect Using Studio 3T - 图2

    3. Choose the Authentication tab and select Legacy in the drop down menu for Authentication Mode.

    5. Choose the SSL tab and check the box Use SSL protocol to connect.

      Connect Using Studio 3T - 图5

    6. Choose Use own Root CA file. Then add the Amazon DocumentDB certificate (you can skip this step if SSL is disabled on your DocumentDB cluster). Check the box to allow invalid hostnames.

      Note

      Don’t have the certificate? You can download it with the following command:

    7. If you are connecting from a client machine outside the Amazon VPC, you need to create a SSH tunnel. You will do this in the SSH tab.

      1. Check the box for Use SSH tunnel and input the SSH address in the SSH Address field. This is your instance Public DNS (IPV4). You can get this URL from your .

      2. For SSH Auth Mode, select Private Key. In the Private Key field, choose the file finder icon to locate and choose the Private key of your Amazon EC2 instance. This is the .pem file (key pair) that you saved while creating your instance in Amazon EC2 Console.

      3. If you are on Linux/macOS client machine, you might have to change the permissions of your private key using the following command:

      Connect Using Studio 3T - 图7

      Note

      This Amazon EC2 instance should be in the same Amazon VPC and security group as your DocumentDB cluster. You can get the SSH address, username and private key from your Amazon EC2 Management Console.

    8. Now test your configuration by choosing the Test connection button.

    9. A diagnostic window should load a green bar to indicate the test was successful. Now choose OK to close out the diagnostic window.

      Connect Using Studio 3T - 图9

    10. Choose Save to save your connection for future use.

    11. Now select your cluster and choose Connect.

      Connect Using Studio 3T - 图11

    Congratulations! You are now successfully connected to your Amazon DocumentDB cluster through Studio 3T.