> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.squarecloud.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Whitelist do MongoDB Atlas (IP dinâmico)

# 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:

```text
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:

```text
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.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/a/4/9/da49f867735c6000/image_1th63g5.png)

---

## 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.