Whitelist de MongoDB Atlas en Square Cloud

Square Cloud usa asignación dinámica de IP para sus aplicaciones. Esto significa que tu instancia no mantiene una IP fija entre reinicios, por lo que MongoDB Atlas necesita permitir conexiones de forma más amplia.

1. El problema de la IP dinámica

Al conectar una base de datos MongoDB Atlas a tu aplicación en Square Cloud, puedes ver este error:

MongoNetworkError: connection 0 to shard-xxx-xxx.mongodb.net:27017 closed

Este problema ocurre porque Atlas no reconoce la IP de origen de tu aplicación, ya que cambia en cada reinicio.

2. ¿Por qué ocurre esto?

MongoDB Atlas exige que añadas las IPs de origen confiables en la whitelist. Como Square Cloud no proporciona una IP estática, no es posible añadir una única dirección fija a Atlas.

3. Cómo corregirlo

Paso a paso

1. Abre el panel de MongoDB Atlas.
2. Accede a la sección de Network Access / IP Access List.
3. Añade la dirección de abajo:

0.0.0.0/0

4. Guarda el cambio.

Observación de seguridad

Añadir 0.0.0.0/0 abre la red para que cualquier IP llegue a tu cluster — así que la seguridad pasa a depender por completo de las capas de autenticación. Como no puedes fijar la IP en Square Cloud, compénsalo con estas mitigaciones concretas:

• Contraseña fuerte y única para el usuario de la base de datos (Atlas ya exige autenticación SCRAM).
• TLS/SSL siempre activo — Atlas fuerza la conexión cifrada por defecto; no lo desactives.
• Usuario con privilegio mínimo: crea un usuario dedicado para la app, con acceso solo a la base que necesita (evita el rol de admin).
• Rotación de credenciales: cambia la contraseña periódicamente y siempre que sospeches de una filtración; nunca subas la connection string a Git.

Así, aun con la red abierta, nadie llega a la base sin las credenciales correctas.

4. Probando la conexión

Después de añadir la whitelist en Atlas, intenta conectar tu aplicación de nuevo. Si el error persiste, verifica:

• Si la base de datos está activa en Atlas.
• Si la string de conexión es correcta.
• Si la aplicación está usando el cluster Atlas correcto.

5. ¿Qué hacer si aún no funciona?

• Confirma el nombre del cluster y el usuario de MongoDB Atlas.
• Verifica que la aplicación esté configurada para conectar en el puerto correcto.
• Si usas VPC o reglas adicionales en Atlas, ajústalas en consecuencia.

Actualizado el: 02/07/2026