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 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 abaAcesso à rede .
Usuário do banco de dados
Para acessar um cluster, é necessário criar um usuário de banco de dados com acesso aos bancos de dados desejados no Atlas cluster. Os usuários de banco de dados são separados dos usuários do Atlas. Os usuários de banco de dados têm acesso aos bancos de dados MongoDB, enquanto os usuários 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áfegoTCP 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. Se você deseja habilitar agrupamentos do Atlas com autenticação e autorização LDAP, você deverá permitir o acesso de rede a partir de clusters do Atlas diretamente para seu LDAP seguro. Você pode permitir o acesso ao seu LDAP utilizando IPs públicos ou privados desde que um nome de host DNS público aponte para um IP que os agrupamentos Atlas podem acessar.
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 analítica foo123-shard-00-03-a1b2c.mongodb.net:27017, o Atlas não garante que o nome de host específico continuará a se referir a um nó de analítica após uma alteração de topologia, como dimensionar 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.