Cómo evitar un proxy corporativo y la inspección SSL de SWG en un Mac
Por qué desactivar Proxies en Ajustes del Sistema de macOS o ejecutar networksetup falla frente a proxies SWG transparentes, y cómo evitarlos por dominio o corregir errores de certificados CLI.
SWG bar · Actualizado
Si desactivar los interruptores de proxy Wi-Fi en Ajustes del Sistema → Red → Proxies —o añadir dominios mediante networksetup -setproxybypassdomains— sigue dejando tu Mac detrás de la inspección SSL del proxy corporativo, tu equipo está utilizando un agente Secure Web Gateway (SWG) transparente (NetworkExtension o túnel utun) en lugar de un proxy HTTP explícito convencional. Para evitar la inspección de la SWG para un nombre de host específico en un Mac autorizado, abre SWG bar → Dominios, selecciona el nombre de host y activa Evitar SWG (o ejecuta swgbar bypass enable <domain>).
La mayoría de los tutoriales sobre proxies en macOS mezclan dos arquitecturas corporativas completamente distintas: los proxies explícitos / archivos PAC tradicionales y los agentes SWG transparentes modernos (como Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope o Cloudflare Gateway). Saber cuál emplea tu Mac explica de inmediato por qué los ajustes estándar de proxy no surten efecto y qué solución funciona realmente.
1. Comprueba si tu Mac usa un proxy explícito o una SWG transparente
Ejecuta dos comprobaciones rápidas para ver cómo se dirige el tráfico en macOS:
- Inspecciona los ajustes explícitos de proxy del sistema:
scutil --proxy
Busca HTTPEnable : 1, HTTPSEnable : 1 o ProxyAutoConfigURLString (una URL .pac). 2. Inspecciona la interceptación real de certificados HTTPS: Abre SWG bar → Resumen (o ejecuta swgbar overview / swgbar domains list --status confirmed).
- Si
scutil --proxyaparece vacío, pero SWG bar muestra una Tasa de inspección de dominios >0%(con dominios Confirmado o Sospechoso y Certificados de intermediario (MITM)), tu Mac está detrás de un agente SWG transparente (NetworkExtension/utun) que captura paquetes por debajo de los ajustes de proxy del sistema de macOS. - Si
scutil --proxymuestra un proxy corporativo o un archivo PAC y SWG bar detecta una CA raíz MITM corporativa, el tráfico se enruta a través de un proxy interceptor explícito/PAC.
2. Proxy explícito frente a proxy SWG transparente en macOS
| Arquitectura | Dónde intercepta macOS el tráfico | ¿Lo evita Ajustes del Sistema → Proxies / networksetup? |
Qué funciona en un Mac autorizado |
|---|---|---|---|
| Proxy HTTP/HTTPS explícito o PAC (no administrado) | Campos de proxy de la configuración del sistema de macOS | Sí, si no está bloqueado por MDM (Omitir ajustes de proxy para estos hosts y dominios) |
Lista de omisión de proxy de macOS o verificación de enrutamiento por dominio |
Proxy explícito bloqueado por MDM o SWG transparente (NetworkExtension / utun) |
Filtro de sockets e IP en el kernel / NetworkExtension por debajo de los interruptores de proxy del navegador | No: los ajustes quedan bloqueados, se sobrescriben o el túnel SWG los ignora por completo | Evasión física IPv4 Hardware por dominio con SWG bar (Cómo evitar una SWG en Mac), exclusiones de pasarela de TI External Domains / Do Not Decrypt o configuración de paquete de CA en CLI |
3. Evita la inspección SSL de un proxy SWG para un dominio concreto en macOS
Cuando una aplicación web específica, un endpoint de API o un cliente de escritorio con certificate pinning falla detrás de un proxy SWG corporativo en una red que administras o estás autorizado a configurar:
- Instala y abre SWG bar (macOS 14+ con chip de Apple, prueba gratuita de 14 días de uso) y reproduce la solicitud para que el nombre de host exacto aparezca en Dominios.
- Abre los detalles del nombre de host y pulsa Activar evasión para este dominio en la fila Evitar SWG, o ejecuta:
swgbar bypass enable <domain>
swgbar bypass status
- Espera a que aparezca Evasión activa y luego recarga la página web o reinicia el terminal o el cliente de escritorio para que los sockets keep-alive existentes se vuelvan a abrir por la interfaz física IPv4
Hardwarede tu Mac (en0/en7). - Verifica con
swgbar probe <domain>que la cadena de certificados pública del origen se presenta sin alteraciones. Ten en cuenta que, si una aplicación tiene configurado su propio proxy explícito (por ejemploHTTP_PROXY/HTTPS_PROXYen~/.zshrc,~/.npmrco~/.gitconfig), debes anular esas variables de proxy para ese host de modo que la aplicación no fuerce el tráfico de nuevo al puerto del proxy explícito.
4. Cuando no puedes evitar el proxy: excepciones de TI y paquetes de CA para CLI
Si tu cortafuegos corporativo bloquea todo el tráfico IPv4 saliente directo que no pasa por el proxy SWG (un perímetro de cierre ante fallos):
- Desactiva la evasión por dominio (
swgbar bypass disable <domain>) para que el nombre de host regrese de inmediato al enrutamiento normal del proxy. - Configura las herramientas CLI para confiar en la CA del proxy corporativo: Apunta
git,curl,npm,Python,Homebrew,Claude CodeyCursora tu archivo PEM de la CA corporativa exportada (SSL_CERT_FILE,NODE_EXTRA_CA_CERTS,REQUESTS_CA_BUNDLE,git http.sslCAInfo) en lugar de desactivar de forma insegura la verificación SSL. Consulta Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA. - Solicita a TI una evasión en la pasarela o excepción de descifrado: Entrega a TI los nombres de host exactos que fallan (incluidos dominios de inicio de sesión y CDN) junto con las pruebas de certificados de SWG bar para que puedan añadir una regla central Do Not Decrypt o External Domains List. Compara ambas capas en Bypass de SWG frente a excepción de inspección TLS.