Esta página describe cómo realizar la conexión al clúster de Atlas utilizando la Atlas CLI o la Interfaz de usuario de Atlas.
Requisitos previos
Lista de acceso IP
Para acceder a un clúster, debes conectarte desde una dirección IP que esté en la lista de acceso IP del proyecto de Atlas. Si necesitas añadir una dirección IP a la lista de acceso IP, puedes hacerlo en el cuadro de diálogo Connect. También puedes agregar la dirección IP desde la pestaña Acceso a la red.
Usuario de base de datos
Para acceder a un clúster, debe crearse un usuario de base de datos con acceso a las bases de datos deseadas en el clúster de Atlas. Los usuarios de base de datos son distintos de los usuarios de Atlas. Los usuarios de bases de datos tienen acceso a las bases de datos de MongoDB, mientras que los usuarios de Atlas tienen acceso a la aplicación Atlas en sí.
Es posible crear un usuario de base de datos para acceder al clúster de Atlas en el cuadro de diálogo Connect. También se puede añadir el usuario de base de datos desde la vista del clúster.
Abra los puertos 27015 a 27017 para acceder a las bases de datos de Atlas
Asegúrese de que su aplicación pueda acceder a su entorno de MongoDB Atlas. Para añadir el acceso de red entrante desde su entorno de aplicación a Atlas, realice una de las siguientes acciones:
Añada las direcciones IP públicas a su lista de acceso IP
Utiliza el emparejamiento de VPC / VNet para agregar direcciones IP privadas.
Agregar nodos privados.
Si su firewall bloquea las conexiones de red salientes, también debe abrir el acceso saliente desde su entorno de aplicación a Atlas. Debe configurar su firewall para permitir que sus aplicaciones establezcan conexiones salientes a los puertos 27015 a 27017 para el tráfico TCP en los nombres de host o direcciones IP de su clúster. Esto otorga a tus aplicaciones acceso a las bases de datos almacenadas en Atlas.
Para obtener la lista actual de direcciones IP de clúster, utiliza el endpoint Devolver todas las direcciones IP para un Proyecto de la API de Administración de 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"
Nota
Por defecto, los clústeres de MongoDB Atlas no necesitan poder iniciar conexiones con los entornos de aplicaciones. Si se desea habilitar clústeres de Atlas con autenticación y autorización por LDAP, se debe permitir el acceso a la red desde los clústeres de Atlas directamente al LDAP seguro. Se puede permitir el acceso al LDAP utilizando IP públicas o privadas siempre que un nombre de host público de DNS apunte a una IP a la que los clústeres de Atlas puedan acceder.
Si no está utilizando el emparejamiento de VPC / VNet y planea conectarse a Atlas mediante direcciones IP públicas, consulte las siguientes páginas para obtener información adicional:
Considerations
Atlas no garantiza que los nombres de host sean coherentes con respecto a los tipos de nodos durante los cambios de topología.
Ejemplo
Si tienes un clúster llamado foo123 que contiene un nodo de análisis foo123-shard-00-03-a1b2c.mongodb.net:27017, Atlas no garantiza que el nombre de host específico continúe refiriéndose a un nodo de análisis después de un cambio de topología, como el escalado de un clúster para modificar su número de nodos o regiones.
Conéctese a su clúster en la nube
Para obtener la cadena de conexión de la implementación, se puede usar Atlas CLI o la interfaz de usuario de Atlas:
Conecte con su clúster en la nube utilizando otros métodos
Para conectarse a su clúster, debe obtener las Cadenas de Conexión de su implementación. Una vez que tengas la cadena de conexión, puedes conectar tu implementación utilizando los siguientes métodos de conexión:
Nota
Para conectarse usando mongodump o mongorestore, utilice la opción Herramientas de línea de comandos en la barra lateral Cluster. Esto crea una plantilla autogenerada para conectarse a tu clúster de Atlas con tu herramienta preferida.
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.