Configurando proxy no Postman

Configurando proxies no Postman

O Postman é a ferramenta mais popular para testar APIs. Configurar proxies no Postman é necessário para: trabalhar em redes corporativas com proxy obrigatório, testar APIs a partir de diferentes geolocalizações, depurar tráfego através de um proxy de interceptação (Fiddler, mitmproxy) e contornar rate limiting.

Configuração do proxy

Via Settings

1. Abra o Postman
2. Clique no ícone de engrenagem (Settings) ou Ctrl+,
3. Vá para a aba "Proxy"

Proxy do sistema

Por padrão, o Postman usa o proxy do sistema:
1. Ative "Use the system proxy" (ativado por padrão)
2. O Postman usa automaticamente as configurações de proxy do Windows/macOS
3. Não requer configuração adicional

Proxy personalizado

1. Desative "Use the system proxy"
2. Ative "Add a custom proxy configuration"
3. Informe:
   - HTTP Proxy: endereço e porta
   - HTTPS Proxy: endereço e porta (pode ser o mesmo)
4. Bypass: domínios que não passam pelo proxy

Autenticação

Se o proxy exigir usuário/senha:
1. Nas configurações de Proxy, ative "This proxy requires authentication"
2. Informe Username e Password
3. O Postman enviará automaticamente o header Proxy-Authorization

Usando variáveis de ambiente

Para uma gestão flexível do proxy, use variáveis do Postman:

1. Crie um Environment (por exemplo, "Production via Proxy")
2. Adicione as variáveis: proxy_url, proxy_user, proxy_pass
3. Use as variáveis no Pre-request Script

Trabalhando com SSL via proxy

Desativando a verificação SSL

Ao trabalhar através de um proxy de interceptação (mitmproxy, Fiddler):
1. Settings → General
2. Desative "SSL certificate verification"
3. Isso permite que o Postman aceite certificados autoassinados do proxy

Adicionando um certificado CA

Para proxies corporativos:
1. Settings → Certificates
2. Clique em "Add CA Certificate"
3. Envie o arquivo PEM do certificado corporativo
4. O Postman passará a confiar nessa CA

Certificado do cliente

Alguns proxies exigem um certificado de cliente:
1. Settings → Certificates
2. Clique em "Add Certificate"
3. Especifique Host, arquivo CRT e arquivo KEY
4. O Postman enviará o certificado ao conectar

Postman como proxy (Interceptor)

O próprio Postman pode atuar como proxy para interceptar requisições de um navegador:

Postman Interceptor

1. Instale a extensão "Postman Interceptor" no Chrome
2. Ative o Interceptor no Postman
3. As requisições do Chrome serão interceptadas no Postman
4. Útil para registrar chamadas de API de sites

Postman Proxy

1. Settings → Proxy → Enable Postman as a proxy
2. Especifique a porta (padrão 5555)
3. Configure seu dispositivo para usar localhost:5555 como proxy
4. Todas as requisições serão registradas no Postman History

Proxies no Postman CLI (Newman)

O Newman é a CLI do Postman, usada para rodar coleções pela linha de comando:

# Via environment variable
export HTTP_PROXY=http://proxy_ip:8080
export HTTPS_PROXY=http://proxy_ip:8080
newman run collection.json

# Via flag
newman run collection.json --env-var "proxy_url=http://proxy_ip:8080"

Pre-request Script para lógica de proxy

// Seleção dinâmica de proxy conforme o ambiente
const env = pm.environment.get("target_env");
if (env === "production") {
    pm.request.proxy = {
        match: "https://*.api.com/*",
        host: "proxy_ip",
        port: 8080
    };
}

Depuração

Postman Console

1. Abra o Postman Console (View → Show Postman Console ou Ctrl+Alt+C)
2. Todas as requisições HTTP, incluindo as conexões via proxy, aparecem aqui
3. Útil para depurar problemas de proxy

Network Log

No Console você pode ver:
- Conexão com o proxy
- Requisição CONNECT (para HTTPS)
- Resposta do proxy
- Resposta final do servidor

Problemas comuns

"Could not get any response"

• Verifique o endereço e a porta do proxy
• Certifique-se de que o proxy está em execução
• Verifique se um firewall está bloqueando a conexão com o proxy

Erro de SSL via proxy

• Desative a verificação SSL em Settings
• Ou adicione o certificado CA do proxy
• Para um proxy de interceptação (Fiddler), instale o certificado CA dele

407 Proxy Authentication Required

• Ative a autenticação nas configurações de proxy
• Verifique usuário e senha
• Certifique-se de que o proxy suporta Basic auth

Conclusão

O Postman oferece configurações de proxy flexíveis para diversos cenários: de proxies corporativos até depuração via proxy de interceptação. O suporte a certificados SSL, variáveis de ambiente e CLI (Newman) torna o trabalho com proxies conveniente tanto na GUI quanto em pipelines automatizados.