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

Atualizado em: 18/05/2026