Esta página descreve como conectar ao seu Atlas cluster utilizando o Atlas CLI ou Atlas UI.
Pré-requisitos
Lista de acesso IP
Para acessar um cluster, você deve se conectar a partir de um endereço IP na lista de acesso IP do projeto do Atlas. Se você precisar adicionar um endereço IP à lista de acesso IP, pode fazê-lo na caixa de diálogo Connect. Você também pode adicionar o endereço IP na aba Acesso à rede.
Usuário do banco de dados
Para acessar um cluster do Atlas, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no cluster do Atlas. Os usuários de banco de dados são separados dos usuários do Atlas. Os usuários do banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários do Atlas têm acesso ao próprio aplicativo Atlas.
Você pode criar um usuário de banco de dados para acessar seu cluster do Atlas na caixa de diálogo Connect. Você também pode adicionar o usuário do banco de dados a partir da visualização Cluster.
Abrir Portas 27015 a 27017 para Acessar Bancos de Dados Atlas
Certifique-se de que seu aplicativo possa alcançar seu ambiente MongoDB Atlas. Para adicionar o acesso de rede de entrada do seu ambiente do aplicativo para o Atlas, faça um dos seguintes:
Adicionar os endereços IP públicos à sua lista de acesso IP
Use emparelhamento VPC/VNet para adicionar endereços IP privados.
Adicionar endpoints privados.
Se o firewall bloquear conexões de rede de saída, você também deverá abrir o acesso de saída do ambiente do aplicativo para o Atlas. Você deve configurar o firewall para permitir que seus aplicativos façam conexões de saída com as portas 27015 a 27017 para o tráfego TCP nos nomes de host ou endereços IP do cluster. Isso faz com que seus aplicativos tenham acesso aos bancos de dados armazenados no Atlas.
Para obter a lista atual de endereços IP do cluster, use o ponto de extremidade Return All IP Addresses for One Project da Administration API do Atlas.
curl --header "Authorization: Bearer <access-token>" \ --header "Accept: application/vnd.atlas.2025-03-12+json" \ --request GET \ "https://cloud.mongodb.com/api/atlas/v2/groups/{GROUP-ID}/ipAddresses"
Observação
Os clusters do MongoDB Atlas, por padrão, não requerem a capacidade de estabelecer conexões com ambientes de aplicativos. Para habilitar a autenticação e autorização LDAP nos seus Atlas Clusters, é necessário conceder aos clusters acesso direto ao seu servidor LDAP seguro. Você pode permitir o acesso ao seu LDAP através de IPs públicos ou privados, desde que um DNS público redirecione para um IP acessível pelos Atlas clusters.
Se você não estiver usando o emparelhamento VPC/VNet e planeja se conectar ao Atlas usando endereços IP públicos, consulte as páginas a seguir para obter mais informações:
Considerações
O Atlas não garante que os nomes de host permaneçam consistentes com os tipos de nó durante as alterações de topologia.
Exemplo
Se você tiver um cluster chamado foo123 contendo um nó de análise foo123-shard-00-03-a1b2c.mongodb.net:27017, o Atlas não garantirá que esse nome de host específico continuará a se referir a um nó de análise depois de uma alteração de topologia, como o dimensionamento de um cluster para modificar seu número de nós ou regiões.
Conecte-se ao seu cluster na nuvem
Para obter a cadeia de conexão de sua implantação, você pode usar a CLI do Atlas ou a IU do Atlas:
Conecte-se ao seu cluster na nuvem usando outros métodos
Para se conectar ao seu cluster, você deve obter as strings de conexão da sua implantação. Após obter a string de conexão, você pode se conectar à sua implantação utilizando os seguintes métodos de conexão:
Observação
Para conectar utilizando mongodump ou mongorestore, utilize a opção Ferramentas de Linha de Comando na barra lateral do Cluster. Isso cria um modelo gerado automaticamente para conexão ao seu cluster Atlas com a ferramenta de sua preferência.
Solução de problemas
Se você estiver enfrentando problemas para se conectar ao seu cluster, consulte Solucionar problemas de conexão.