

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectar a um cluster Amazon DocumentDB a partir do Studio 3T
<a name="studio3t"></a>

O [Studio 3T](https://studio3t.com/) é uma GUI e IDE popular para desenvolvedores e engenheiros de dados que trabalham com o MongoDB. Ele oferece vários recursos poderosos: visualizações em árvore, tabela e JSON de seus dados, fáceis import/export em CSV, JSON, SQL e, opção de consulta flexível BSON/mongodump, uma interface visual de arrastar e soltar, um shell mongo integrado com preenchimento automático, um editor de pipeline de agregação e suporte a consultas SQL.

## Pré-requisitos
<a name="prerequisites"></a>
+ Se você ainda não tem um cluster Amazon DocumentDB usando o Amazon EC2 como bastion/jump host, siga as instruções sobre como [se conectar ao Amazon](https://docs.aws.amazon.com/documentdb/latest/devguide/connect-ec2.html) EC2.
+ Se você não tem o Studio 3T, [faça o download e instale](https://studio3t.com/download). 

## Conectar com o Studio 3T
<a name="connect-studio3t"></a>

1. Escolha **Conectar** no canto superior esquerdo da barra de ferramentas.  
![Interface do Studio 3T mostrando a tela de boas-vindas e a opção Conectar-se destacada no canto superior esquerdo.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-connect.png)

1. Escolha **Nova conexão** no canto superior esquerdo da barra de ferramentas.  
![Interface do Gerenciador de conexões com a opção Nova conexão destacada no canto superior esquerdo.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-newconn.png)

1. Na guia **Servidor**, no campo **Servidor**, digite as informações do endpoint do cluster.  
![Guia Servidor na interface Nova conexão com o campo de entrada Servidor destacado.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-endpoint.png)
**nota**  
Não consegue encontrar seu endpoint de cluster? Basta seguir as etapas [aqui](https://docs.aws.amazon.com/documentdb/latest/devguide/db-instance-endpoint-find.html).

1. Escolha a guia **Autenticação** e selecione **Legado** no menu suspenso do **Modo de Autenticação**.  
![Guia Autenticação na interface Nova conexão com o modo de autenticação legado selecionado e informações de nome de usuário, senha e banco de dados de autenticação fornecidas.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-auth.png)

1. Insira seu nome de usuário e credenciais nos campos **Nome de usuário** e **Senha**.

1. Escolha a guia **SSL** e marque a caixa **Usar protocolo SSL para conectar**.  
![Guia SSL na interface Nova conexão com a opção Usar protocolo SSL para se conectar selecionada.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-ssl.png)

1. Escolha **Usar arquivo CA raiz próprio**. Em seguida, adicione o certificado Amazon DocumentDB (você pode pular essa etapa se o SSL estiver desabilitado no seu cluster do DocumentDB). Marque a caixa para permitir **nomes de host inválidos**.  
![Guia SSL na interface Nova conexão com o arquivo CA raiz inserido e permitir nomes de host inválidos selecionado.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-ssl.png)
**nota**  
Não tem o certificado? É possível baixar com o seguinte comando:  
 `wget https://truststore.pki.rds.amazonaws.com/global/global-bundle.pem ` 

1. Se estiver se conectando a partir de uma máquina externa à Amazon VPC, você precisará criar um túnel SSH. Você fará isso na guia **SSH**.

   1. Marque a caixa **Usar túnel SSH** e insira o endereço SSH no campo **Endereço SSH.** Essa é a sua instância DNS pública (IPV4). É possível obter essa URL no [Console Amazon EC2 Management](https://console.aws.amazon.com/ec2).

   1. Insira seu nome de usuário. Este é o nome de usuário da instância do Amazon EC2 

   1. Para o **Modo de Autenticação SSH**, selecione **Chave privada**. No campo **Chave privada**, escolha o ícone do localizador de arquivos para localizar e selecionar a chave privada da sua instância do Amazon EC2. Esse é o arquivo .pem (par de chave) que você salvou ao criar sua instância no console do Amazon EC2.

   1. Se você estiver na máquina Linux/macOS cliente, talvez seja necessário alterar as permissões da sua chave privada usando o seguinte comando:

      `chmod 400 /fullPathToYourPemFile/<yourKey>.pem`  
![Guia SSH na interface Nova conexão com as credenciais de túnel de SSH inseridas.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-ssh.png)
**nota**  
Essa instância do Amazon EC2 deve estar na mesma Amazon VPC e grupo de segurança que o cluster do DocumentDB. É possível obter o endereço SSH, o nome de usuário e a chave privada no [Console de Gerenciamento do Amazon EC2](https://console.aws.amazon.com/ec2).

1. Agora teste sua configuração escolhendo o botão **Testar conexão**.  
![Interface Nova conexão com o botão Testar conexão destacado no canto inferior esquerdo.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-testbutton.png)

1. Uma janela de diagnóstico deve carregar uma barra verde para indicar que o teste foi bem-sucedido. Agora escolha **OK** para fechar a janela de diagnóstico.  
![Janela de diagnóstico que aparece após um teste de conexão com êxito.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-testconn.png)

1. Escolha **Salavar** para salvar a conexão para uso futuro.  
![Interface Nova conexão com o botão Salvar destacado.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-save.png)

1. Agora selecione seu cluster e escolha **Conectar**.  
![Interface Gerenciador de conexões com o botão Conextar-se destacado.](http://docs.aws.amazon.com/pt_br/documentdb/latest/devguide/images/studio3t/studio3t-finalconnect.png)

Parabéns\! Agora você está conectado ao seu cluster Amazon DocumentDB por meio do Studio 3T.