Configuración de Proxies en Insomnia
Introducción
Insomnia es un popular cliente HTTP para desarrolladores, una alternativa a Postman. El soporte de proxy en Insomnia es crucial para trabajar en redes corporativas, probar APIs desde varias geolocalizaciones y depurar tráfico a través de un proxy interceptor.
Configuración Básica
Configuración en Insomnia
- Abrir Insomnia
- Ir a Preferencias (Ctrl+,)
- Pestaña "General" → sección "HTTP Network Proxy"
- Habilitar "Enable Proxy" (Activar Proxy)
- Introducir la dirección del proxy en el formato: http://proxy_ip:port
- Para HTTPS: https://proxy_ip:port
- Sin Proxy: localhost, *.local
Autenticación
Insomnia soporta proxies con autenticación:
- Formato de URL: http://user:pass@proxy_ip:port
- O a través de Variables de Entorno: HTTP_PROXY, HTTPS_PROXY
Variables de Entorno
Insomnia lee las variables de entorno del sistema:
- HTTP_PROXY / http_proxy
- HTTPS_PROXY / https_proxy
- NO_PROXY / no_proxy
Configuración Avanzada
Variables de Entorno
La mayoría de las herramientas soportan variables de entorno estándar para proxies:
- HTTP_PROXY / http_proxy — proxy para solicitudes HTTP
- HTTPS_PROXY / https_proxy — proxy para solicitudes HTTPS
- NO_PROXY / no_proxy — lista de exclusiones (direcciones que evitan el proxy)
- ALL_PROXY / all_proxy — proxy para todos los protocolos
SSL y Certificados Auto-Firmados
Los proxies corporativos a menudo usan sus propios certificados SSL. Para trabajar a través de ellos, necesitas:
1. Obtener el certificado CA del proxy del administrador
2. Añadirlo al almacén de certificados del sistema
3. O deshabilitar la verificación SSL (solo para pruebas)
Autenticación
Se soportan dos métodos principales de autenticación:
Nombre de usuario y Contraseña — autenticación HTTP Basic estándar. Las credenciales se envían con cada solicitud. Formato de URL: http://user:pass@proxy_ip:port
Por dirección IP (lista blanca) — tu IP se añade a una lista blanca. No es necesario enviar credenciales.
Verificación
Después de la configuración, verifica:
1. Ejecuta una solicitud de prueba a través del proxy
2. Asegúrate de que la dirección IP haya cambiado
3. Verifica la velocidad de conexión
4. Verifica la ausencia de fugas de DNS
Solución de Problemas
Problemas de Conexión del Proxy
- Verifica la corrección de la dirección y el puerto
- Asegúrate de que el firewall no esté bloqueando la conexión
- Verifica la accesibilidad del proxy desde tu red
Errores SSL
- Para proxies corporativos, añade el certificado CA
- Para pruebas, deshabilita temporalmente la verificación SSL
- Actualiza las librerías SSL a la última versión
Errores de Autenticación
- Verifica el nombre de usuario y la contraseña
- Asegúrate del formato correcto de las credenciales
- Intenta codificar URL los caracteres especiales en la contraseña
Mejores Prácticas
- Usa variables de entorno — para flexibilidad y seguridad
- No codifiques credenciales — usa variables de entorno o archivos de configuración
- Configura exclusiones — no uses proxy para localhost y direcciones internas
- Documenta la configuración — en el README del proyecto o la wiki del equipo
- Prueba después de los cambios — cualquier cambio de configuración requiere verificación
Conclusión
Una configuración de proxy adecuada asegura un funcionamiento estable de la herramienta y conexiones seguras. Sigue las recomendaciones de esta guía y verifica siempre la funcionalidad después de la configuración.