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 permite conexiones desde cualquier IP a tu cluster Atlas. Usa esta configuración solo cuando sea necesario y revisa las reglas de seguridad de MongoDB Atlas para limitar el acceso por usuario y firewall cuando sea posible.

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: 13/06/2026