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.
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 tiene un clúster llamado foo123 que contiene un nodo de análisis foo123-shard-00-03-a1b2c.mongodb.net:27017, Atlas no garantiza que ese nombre de host específico seguirá haciendo referencia a un nodo de análisis después de un cambio de topología, como
escalar un clúster para modificar su número de nodos o regiones.
Requisitos previos
Lista de acceso IP
Para acceder a un clúster, debe conectarse desde una dirección IP de la lista de acceso IP del proyecto Atlas. Si necesita agregar una dirección IP a la lista de acceso IP, puede hacerlo en el Connect Cuadro de diálogo. También puede 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 crear un Usuario de base de datos con acceso a las bases de datos deseadas en su clúster Atlas. Los usuarios de base de datos son independientes de los usuarios de Atlas. Los usuarios de base de datos tienen acceso a las bases de datos MongoDB, mientras que los usuarios de Atlas tienen acceso a la propia aplicación Atlas.
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 habilitar el acceso saliente desde su entorno de aplicación a Atlas. Debe configurar su firewall para permitir que sus aplicaciones realicen conexiones salientes a los puertos 27015 a 27017. TráficoTCP en los nombres de host o direcciones IP de su clúster. Esto permite que sus aplicaciones accedan a las bases de datos almacenadas en Atlas.
Para obtener la lista actual de direcciones IP del clúster, utilice el punto final 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 a sus 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:
Conéctese a su clúster en la nube
Para conectarse a su clúster, debe obtener la cadena de conexión de su implementación. Una vez que tenga la cadena de conexión, puede conectarse a su implementación utilizando los siguientes métodos de conexión:
Nota
Para realizar la conexión usando mongodump o mongorestore, se debe usar la pestaña Herramientas de línea de comandos. La pestaña crea una plantilla generada automáticamente para conectarse al clúster de Atlas con la herramienta preferida.
Para obtener la cadena de conexión de la implementación, se puede usar Atlas CLI o la interfaz de usuario de Atlas:
Puede usar el Atlas CLI para obtener la cadena de conexión estándar de su implementación.
Para obtener las cadenas de conexión SRV del clúster de Atlas usando Atlas CLI, se debe ejecutar el siguiente comando:
atlas clusters connectionStrings describe <clusterName> [options]
Para aprender más sobre la sintaxis de comandos y los parámetros, consulta la documentación de Atlas CLI para atlas clusters connectionStrings describe.
Por ejemplo, si el Atlas CLI devuelve la siguiente cadena de conexión:
mongodb+srv://mycluster.abcd1.mongodb.net
Puede conectarse a su implementación usando mongosh al incluir la cadena de conexión en el comando mongosh:
mongosh "mongodb+srv://mycluster.abcd1.mongodb.net/myFirstDatabase" --apiVersion 1 --username <username>
Nota
Para conectarse exitosamente a Atlas, se debe agregar el nombre de usuario y el nombre de la base de datos a la cadena de conexión. En algunos casos, como cuando se usa mongosh desde la terminal, Atlas solicita que se ingrese la contraseña de usuario de la base de datos.
En Atlas, ve a la página Clusters de tu proyecto.
Si aún no se muestra, seleccione la organización que contiene su proyecto deseado en el menú Organizations de la barra de navegación.
Si aún no aparece, selecciona el proyecto deseado en el menú Projects de la barra de navegación.
En la barra lateral, haz clic en Clusters en la sección Database.
La página de clústeres se muestra.
Elija cómo desea limitar las conexiones a tu clúster.
Add a Connection IP Address
Importante
Omite este paso si Atlas indica en el paso Setup connection security que ya se ha configurado una entrada de la lista de acceso IP en el clúster. Para gestionar la lista de acceso IP, se debe consultar Agregar entradas a la lista de acceso.
Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas le solicita añadir una dirección IP a la lista de acceso IP del proyecto. Puede hacerse:
Se debe hacer clic en Add Your Current IP Address para permitir el acceso desde tu dirección IP actual.
Haz clic en Add an IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
Add a Connection IP Address
Importante
Omita este paso si Atlas indica en el paso Setup connection security que ya ha configurado una entrada de la lista de acceso IP en su clúster. Para gestionar la lista de acceso IP, consulte Agregar entradas a la lista de acceso IP.
Atlas permite conexiones estándar de clientes al clúster desde las entradas de la lista de acceso IP del proyecto. La lista de acceso IP del proyecto difiere de la lista de acceso a la API, que restringe el acceso a la API a direcciones IP o CIDR específicas.
Si la lista de acceso IP está vacía, Atlas solicitará agregar una dirección IP a la lista de acceso IP del proyecto. Haz clic en Add a Different IP Address para agregar una sola dirección IP o un rango de direcciones con notación CIDR.
Ingresa una descripción opcional para la dirección IP recién agregada o el rango CIDR. Haz clic en Add IP Address para agregar la dirección a la lista de acceso IP.
En Choose Connection Type, selecciona Private Endpoint.
Si se ven las opciones Private Link Type, seleccionar una de las siguientes opciones:
Optimized SRV Connection para conexiones equilibradas.
Legacy SRV Connection para conexiones no balanceadas.
Para obtener más información, consulta ¿Cómo puedo optimizar el rendimiento de la conexión para clústeres particionados mediante nodos privados?.
En Choose Private Endpoint, selecciona el endpoint que desea usar.
Cree un usuario de base de datos.
Importante
Omita este paso si Atlas indica en el paso Setup connection security que tiene al menos un usuario de base de datos configurado en su proyecto. Para gestionar los usuarios de base de datos existentes, consulte Configurar usuarios de base de datos.
Para acceder al clúster, necesita un usuario de MongoDB con acceso a la base de datos deseada en el clúster de su proyecto. Si su proyecto no tiene usuarios de MongoDB, Atlas le solicitará que cree un nuevo usuario con el rol de administrador de Atlas.
Introducir el Username del nuevo usuario.
Introduzca un Password para este nuevo usuario o haga clic en Autogenerate Secure Password.
Hacer clic en Create Database User para guardar al usuario.
Se debe usar este usuario para realizar la conexión al clúster en el siguiente paso.
Una vez que se haya añadido una dirección IP a la lista de acceso IP y un usuario de base de datos, se debe hacer clic en Choose Your Connection Method.
Conéctese a una implementación local con el Atlas CLI
Para conectarse a una implementación de Atlas usando el Atlas CLI, ejecute el siguiente comando:
atlas deployments connect [deploymentName] [options]
Para aprender más sobre la sintaxis y los parámetros del comando, consulte la documentación de Atlas CLI para ver la conexión de implementación de Atlas.
Solución de problemas
En caso de problemas para conectarse al clúster, consultar Solucionar problemas de conexión.