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
To access a cluster, you must have a database user with access to the desired databases on your Atlas cluster. Database users are separate from Atlas users. Database users have access to MongoDB databases, while Atlas users have access to the Atlas application itself.
Puede crear un usuario de base de datos para acceder a su clúster de Atlas en el cuadro de diálogo Connect. También puede añadir el usuario de base de datos desde la vista del clúster. Atlas crea un usuario de base de datos cuando crea su primer 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 cortafuegos bloquea las conexiones de red salientes, también debe abrir el acceso saliente desde su entorno de aplicación a Atlas. Debes configurar tu firewall para permitir que tus aplicaciones realicen conexiones salientes a los puertos 27015 a 27017 para el tráfico TCP en los nombres de host o direcciones IP de tu clúster. Esto otorga a tus aplicaciones acceso a 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 desea activar clústeres de Atlas con autenticación y autorización LDAP, debe permitir el acceso a la red desde los clústeres de Atlas directamente a su LDAP seguro. Puede permitir el acceso a su LDAP mediante el uso de IP públicas o privadas siempre que un nombre de host DNS público 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
To connect using mongodump or mongorestore, use the Command Line Tools option in the Cluster sidebar. This creates an auto-generated template for connecting to your Atlas cluster with your preferred tool.
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.