Configurando Proxy no Insomnia

Configurando Proxies no Insomnia

Introdução

O Insomnia é um cliente HTTP popular entre desenvolvedores, uma alternativa ao Postman. O suporte a proxy no Insomnia é essencial para trabalhar em redes corporativas, testar APIs a partir de diferentes geolocalizações e depurar tráfego por meio de um proxy interceptador.

Configuração básica

Configuração no Insomnia

1. Abra o Insomnia
2. Vá em Preferences (Ctrl+,)
3. Aba "General" → seção "HTTP Network Proxy"
4. Ative "Enable Proxy"
5. Informe o endereço do proxy no formato: http://proxy_ip:port
6. Para HTTPS: https://proxy_ip:port
7. No Proxy: localhost, *.local

Autenticação

O Insomnia suporta proxies com autenticação:
- Formato de URL: http://user:pass@proxy_ip:port
- Ou via variáveis de ambiente: HTTP_PROXY, HTTPS_PROXY

Variáveis de ambiente

O Insomnia lê as variáveis de ambiente do sistema:
- HTTP_PROXY / http_proxy
- HTTPS_PROXY / https_proxy
- NO_PROXY / no_proxy

Configuração avançada

Variáveis de ambiente

A maioria das ferramentas suporta as variáveis de ambiente padrão para proxies:
- HTTP_PROXY / http_proxy — proxy para requisições HTTP
- HTTPS_PROXY / https_proxy — proxy para requisições HTTPS
- NO_PROXY / no_proxy — lista de exclusões (endereços que ignoram o proxy)
- ALL_PROXY / all_proxy — proxy para todos os protocolos

SSL e certificados autoassinados

Proxies corporativos costumam usar seus próprios certificados SSL. Para trabalhar por meio deles, você precisa:
1. Obter o certificado CA do proxy com o administrador
2. Adicioná-lo ao repositório de certificados do sistema
3. Ou desativar a verificação SSL (apenas para testes)

Autenticação

Dois métodos principais de autenticação são suportados:

Usuário e senha — autenticação HTTP Basic padrão. As credenciais são enviadas a cada requisição. Formato de URL: http://user:pass@proxy_ip:port

Por endereço IP (whitelist) — seu IP é adicionado a uma lista de permissões. Não é preciso enviar credenciais.

Verificação

Depois da configuração, confira:
1. Execute uma requisição de teste através do proxy
2. Verifique se o endereço IP mudou
3. Meça a velocidade da conexão
4. Confirme a ausência de vazamentos de DNS

Solução de problemas

Problemas de conexão com o proxy

• Verifique se o endereço e a porta estão corretos
• Verifique se o firewall não está bloqueando a conexão
• Confira a acessibilidade do proxy a partir da sua rede

Erros de SSL

• Para proxies corporativos, adicione o certificado CA
• Para testes, desative temporariamente a verificação SSL
• Atualize as bibliotecas SSL para a versão mais recente

Erros de autenticação

• Confira o usuário e a senha
• Verifique se o formato das credenciais está correto
• Tente codificar em URL os caracteres especiais da senha

Boas práticas

1. Use variáveis de ambiente — para flexibilidade e segurança
2. Não deixe credenciais no código — use variáveis de ambiente ou arquivos de configuração
3. Configure exclusões — não passe localhost e endereços internos pelo proxy
4. Documente as configurações — no README do projeto ou na wiki do time
5. Teste após alterações — qualquer mudança de configuração exige verificação

Conclusão

Uma configuração correta de proxy garante funcionamento estável da ferramenta e conexões seguras. Siga as recomendações deste guia e sempre verifique o funcionamento após a configuração.