Whitelist do MongoDB Atlas na Square Cloud

A Square Cloud usa alocação dinâmica de IP para suas aplicações. Isso significa que sua instância não mantém um IP fixo entre reinícios, então o MongoDB Atlas precisa permitir conexões de forma mais ampla.

1. O problema do IP dinâmico

Ao conectar um banco MongoDB Atlas à sua aplicação Square Cloud, você pode ver este erro:

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

Esse problema acontece porque o Atlas não reconhece o IP de origem da sua aplicação, já que ele muda a cada reinício.

2. Por que isso acontece?

O MongoDB Atlas exige que você adicione os IPs de origem confiáveis na whitelist. Como a Square Cloud não fornece um IP estático, não é possível adicionar um único endereço fixo ao Atlas.

3. Como corrigir

Passo a passo

1. Abra o painel do MongoDB Atlas.
2. Acesse a seção de Network Access / IP Access List.
3. Adicione o endereço abaixo:

0.0.0.0/0

4. Salve a alteração.

Observação de segurança

Adicionar 0.0.0.0/0 abre a rede para qualquer IP alcançar seu cluster — então a segurança passa a depender totalmente das camadas de autenticação. Como não dá para fixar o IP na Square Cloud, compense com estas mitigações concretas:

• Senha forte e única para o usuário do banco (o Atlas já exige autenticação SCRAM).
• TLS/SSL sempre ativo — o Atlas força a conexão criptografada por padrão; não desative.
• Usuário com privilégio mínimo: crie um usuário dedicado para a aplicação, com acesso só ao banco necessário (evite o papel de admin).
• Rotação de credenciais: troque a senha periodicamente e sempre que suspeitar de vazamento; nunca versione a connection string no Git.

Assim, mesmo com a rede aberta, ninguém acessa o banco sem as credenciais corretas.

4. Testando a conexão

Depois de adicionar a whitelist no Atlas, tente conectar sua aplicação de novo. Se o erro persistir, verifique:

• Se o banco de dados está ativo no Atlas.
• Se a string de conexão está correta.
• Se a aplicação está usando o cluster Atlas certo.

5. O que fazer se ainda não funcionar?

• Confirme o nome do cluster e o usuário do MongoDB Atlas.
• Verifique se a aplicação está configurada para conectar na porta correta.
• Se você usa VPC ou regras adicionais no Atlas, ajuste-as de acordo.

Atualizado em: 02/07/2026