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

# Problemas de conexão: firewall e bloqueios de IP

# Problemas de conexão: Firewall e bloqueios de IP

É comum que, ao tentar conectar seu bot ou site a um banco de dados externo (como MongoDB Atlas) ou a uma API de terceiros, a conexão seja recusada. Na maioria das vezes, isso não é um erro no seu código, mas sim uma barreira de segurança do serviço de destino.

---

## 1. Por que a conexão é bloqueada?

A Square Cloud utiliza infraestrutura de ponta localizada nos **Estados Unidos**. Muitos serviços de segurança e bancos de dados possuem firewalls que, por padrão, bloqueiam acessos originados de IPs de **datacenters** e/ou **estrangeiros** para prevenir ataques de força bruta ou acessos não autorizados.

---

## 2. Solução A: Liberação via ASN (Recomendado)

A forma mais profissional e segura de garantir que sua aplicação sempre consiga se conectar a um serviço é liberar o **ASN (Autonomous System Number)** da Square Cloud no firewall do serviço de destino.

Como a Square utiliza uma rede dinâmica, onde seu IP muda ao reiniciar a aplicação. Ao liberar o ASN, você autoriza toda a rede da Square Cloud, garantindo que, mesmo que o IP mude, sua aplicação continue conectada sem interrupções.

*   **Vantagem:** Segurança alta e baixa manutenção.
*   **Como fazer:** Procure pelas configurações de "Network Access" ou "Whitelisting" no serviço que você está usando e verifique se eles suportam liberação por ASN ou por faixas de IP (CIDR).

---

## 3. Solução B: Liberação Total (0.0.0.0/0)

Para serviços como o **MongoDB Atlas** ou instâncias de bancos de dados gerenciados, existe a opção de permitir conexões de qualquer lugar do mundo.

Ao configurar a lista de acesso de IP como `0.0.0.0/0`, você está dizendo ao firewall: "Aceite conexões de qualquer IP, desde que a senha/token de acesso esteja correta".

### Como configurar no MongoDB Atlas:
1.  Acesse o painel do MongoDB Atlas.
2.  Vá em **Network Access**.
3.  Clique em **Add IP Address**.
4.  Clique no botão **Allow Access From Anywhere** (isso preencherá `0.0.0.0/0`).
5.  Salve as alterações.

> **⚠️ Nota de Segurança:** Ao usar esta opção, certifique-se de que sua senha de banco de dados é extremamente forte e complexa, já que a barreira de IP estará aberta.

---

## 4. Diagnóstico de Conexão

Se você liberou o IP e ainda assim não consegue conectar, verifique:

*   **String de Conexão:** Certifique-se de que não há caracteres especiais na senha que precisem de "URL Encoding" (como `@` ou `#`).
*   **Protocolo:** Verifique se o serviço exige `ssl=true` ou parâmetros específicos de TLS na URL de conexão.
*   **Logs da Square:** No dashboard, veja se o log indica um erro de `Timeout` (provável firewall) ou `Authentication Failed` (senha incorreta).