Configuración de Proxy en Postman

Configuración de Proxies en Postman

Postman es la herramienta más popular para probar APIs. Configurar proxies en Postman es necesario para: trabajar en redes corporativas con proxies obligatorios, probar APIs desde diferentes geolocalizaciones, depurar tráfico a través de un proxy interceptor (Fiddler, mitmproxy) y evitar la limitación de velocidad (rate limiting).

Configuración del Proxy

A través de la Configuración

1. Abre Postman
2. Haz clic en el icono de engranaje (Configuración) o Ctrl+,
3. Ve a la pestaña "Proxy"

Proxy del Sistema

Por defecto, Postman usa el proxy del sistema:
1. Habilita "Usar el proxy del sistema" (habilitado por defecto)
2. Postman usa automáticamente la configuración de proxy de Windows/macOS
3. No requiere configuración adicional

Proxy Personalizado

1. Deshabilita "Usar el proxy del sistema"
2. Habilita "Añadir una configuración de proxy personalizada"
3. Introduce:
   - Proxy HTTP: dirección y puerto
   - Proxy HTTPS: dirección y puerto (pueden ser los mismos)
4. Bypass: dominios que omiten el proxy

Autenticación

Si el proxy requiere un nombre de usuario/contraseña:
1. En la configuración del Proxy, habilita "Este proxy requiere autenticación"
2. Introduce el Nombre de usuario y la Contraseña
3. Postman enviará automáticamente el encabezado Proxy-Authorization

Uso de Variables de Entorno

Para una gestión flexible del proxy, usa las variables de Postman:

1. Crea un Entorno (por ejemplo, "Producción vía Proxy")
2. Añade variables: proxy_url, proxy_user, proxy_pass
3. Usa las variables en el Script de pre-solicitud

Trabajo con SSL a través de Proxy

Deshabilitar la Verificación SSL

Cuando trabajes a través de un proxy interceptor (mitmproxy, Fiddler):
1. Configuración → General
2. Deshabilita "Verificación de certificado SSL"
3. Esto permite a Postman aceptar certificados de proxy autofirmados

Añadir un Certificado CA

Para proxies corporativos:
1. Configuración → Certificados
2. Haz clic en "Añadir certificado CA"
3. Sube el archivo PEM del certificado corporativo
4. Postman confiará en esta CA

Certificado de Cliente

Algunos proxies requieren un certificado de cliente:
1. Configuración → Certificados
2. Haz clic en "Añadir certificado"
3. Especifica el Host, el archivo CRT, el archivo KEY
4. Postman enviará el certificado al conectarse

Postman como Proxy (Interceptor)

Postman puede actuar como un proxy para interceptar solicitudes de un navegador:

Interceptor de Postman

1. Instala la extensión "Postman Interceptor" en Chrome
2. Habilita Interceptor en Postman
3. Las solicitudes de Chrome serán interceptadas en Postman
4. Útil para registrar llamadas a la API de sitios web

Proxy de Postman

1. Configuración → Proxy → Habilitar Postman como proxy
2. Especifica el puerto (por defecto 5555)
3. Configura tu dispositivo para usar localhost:5555 como proxy
4. Todas las solicitudes se registrarán en el Historial de Postman

Proxies en Postman CLI (Newman)

Newman es la CLI para Postman, utilizada para ejecutar colecciones desde la línea de comandos:

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

Script de Pre-solicitud para Lógica de Proxy

// Dynamic proxy selection based on environment
const env = pm.environment.get("target_env");
if (env === "production") {
    pm.request.proxy = {
        match: "https://*.api.com/*",
        host: "proxy_ip",
        port: 8080
    };
}

Depuración

Consola de Postman

1. Abre la Consola de Postman (Ver → Mostrar Consola de Postman o Ctrl+Alt+C)
2. Todas las solicitudes HTTP, incluidas las conexiones de proxy, son visibles aquí
3. Útil para depurar problemas de proxy

Registro de Red

En la Consola, puedes ver:
- Conexión al proxy
- Solicitud CONNECT (para HTTPS)
- Respuesta del proxy
- Respuesta final del servidor

Problemas Comunes

"No se pudo obtener ninguna respuesta"

• Verifica la dirección y el puerto del proxy
• Asegúrate de que el proxy esté en funcionamiento
• Comprueba si un firewall está bloqueando la conexión al proxy

Error SSL a través de Proxy

• Deshabilita la verificación SSL en Configuración
• O añade el certificado CA del proxy
• Para un proxy interceptor (Fiddler), instala su certificado CA

407 Proxy Authentication Required

• Habilita la autenticación en la configuración del proxy
• Verifica el nombre de usuario y la contraseña
• Asegúrate de que el proxy admita autenticación Basic

Conclusión

Postman ofrece configuraciones de proxy flexibles para varios escenarios: desde proxies corporativos hasta depuración a través de un proxy interceptor. El soporte para certificados SSL, variables de entorno y CLI (Newman) hace que trabajar con proxies sea conveniente tanto en la GUI como en pipelines automatizados.