Inspección SSL de Zscaler en Mac: cómo comprobar y evitar por dominio

Comprueba si Zscaler Client Connector descifra HTTPS en tu Mac, por qué falla cerrar ZCC bajo Tamper Protection y cómo evitarlo por dominio o configurar la confianza de CA en CLI.

SWG bar · Actualizado

Para comprobar si Zscaler (ZIA / Zscaler Client Connector) está descifrando el tráfico HTTPS en tu Mac, abre SWG bar → Resumen (o ejecuta swgbar overview) y verifica si la Tasa de inspección de dominios supera el 0% con una Zscaler Root CA o una CA intermedia corporativa en Certificados de intermediario (MITM). Para evitar la inspección SSL de Zscaler para un único nombre de host que falla 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 las guías en línea para eludir Zscaler suponen que tienes acceso al Zscaler Admin Portal (ZIA). En un MacBook corporativo administrado con Jamf, Kandji o Intune, los desarrolladores y empleados rara vez tienen acceso al portal; sin embargo, Z-Tunnel 2.0 (NetworkExtension / túnel utun) y la Zscaler Root CA rompen habitualmente aplicaciones con certificate pinning, Homebrew, npm, git, Python, Docker, Claude Code y Cursor.

1. Comprueba si Zscaler está inspeccionando HTTPS activamente en tu Mac

Como MDM preinstala y confía en la Zscaler Root CA en el Llavero de macOS, Safari y Chrome muestran un candado normal incluso mientras Zscaler realiza HTTPS break-and-inspect. Verifica el descifrado por dominio con cualquiera de estos dos métodos:

  • Comprobación continua con SWG bar: Instala SWG bar (macOS 14+ con chip de Apple, prueba gratuita de 14 días de uso) y visita los sitios de destino. Abre SWG bar → Dominios o Certificados —o ejecuta swgbar probe <domain>— para comprobar si el dominio aparece como Confirmado interceptado por Zscaler Root CA (o la CA intermedia de Zscaler de tu empresa) o si pasa con Ruta pública.
  • Comprobación puntual de un dominio en Terminal:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Si issuer= muestra Zscaler o la CA intermedia personalizada de Zscaler de tu organización en lugar de una CA pública (como DigiCert, Let’s Encrypt o Google Trust Services), la inspección SSL de Zscaler está activa para ese nombre de host. Consulta Verificar certificados TLS con OpenSSL y security verify-cert para contrastar las huellas digitales SHA-256.

2. Por qué falla cerrar sesión o descargar Zscaler Client Connector

Intentar desactivar Zscaler de forma global en un Mac administrado casi siempre resulta contraproducente:

  • Tamper Protection: La mayoría de los perfiles corporativos de ZCC exigen una contraseña única de TI para cerrar sesión o desactivar Internet Security (ZIA), y sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* queda bloqueado o se reinicia de inmediato.
  • Z-Tunnel 2.0 ignora los ajustes de proxy del sistema: Desactivar los interruptores de proxy HTTP/HTTPS del Wi-Fi en Ajustes del Sistema de macOS no tiene ningún efecto sobre el desvío de paquetes de Z-Tunnel 2.0.
  • Acceso corporativo roto: Incluso si ZCC se detiene, las aplicaciones internas de ZPA (Zscaler Private Access) y el SSO condicionado por postura del dispositivo (Okta, Entra ID) dejan de funcionar.

3. Tres formas prácticas de gestionar la inspección SSL de Zscaler en macOS

Enfoque Quién lo controla ¿Mantiene activos ZCC y el SSO corporativo? Mejor caso de uso
Evasión de SWG por dominio (SWG bar) Usuario local del Mac (en redes autorizadas) Sí: enruta solo el nombre de host seleccionado por la interfaz física IPv4 Hardware de tu Mac Alivio inmediato por nombre de host para apps con pinning, WebSockets o APIs de desarrollo rotas sin desactivar ZCC (Cómo evitar una SWG en Mac)
Exclusión en el Zscaler Admin Portal (Do Not Inspect / App Profile) Equipo de TI / Seguridad empresarial Sí Exención permanente para toda la organización en Policy → SSL Inspection → Do Not Inspect o App Profiles → Hostname/IP Bypass en macOS (Bypass de SWG frente a excepción TLS)
Exportar y confiar en Zscaler Root CA en herramientas CLI Desarrollador local Sí (el tráfico sigue inspeccionado) La política corporativa exige enrutamiento descifrado y git, npm, brew, Python, Claude Code o Cursor fallan con unable to get local issuer certificate

4. Activa la evasión por dominio o configura Zscaler Root CA en herramientas CLI

Opción A: Evasión por dominio con SWG bar (cuando tengas autorización)

  1. Abre SWG bar → Dominios, busca el nombre de host exacto que falla (ten en cuenta que los dominios de inicio de sesión, API y CDN son nombres de host independientes; consulta evasión multidominio de SSO, API y CDN) y pulsa Activar evasión para este dominio junto a Evitar SWG, o ejecuta swgbar bypass enable <domain>.
  2. Espera a que aparezca Evasión activa y luego reinicia la pestaña del navegador, el IDE o la sesión de CLI para que las conexiones agrupadas se reabran por la ruta directa IPv4 Hardware.
  3. Verifica con swgbar probe <domain> que ahora se devuelve la cadena de certificados pública del servidor de origen. Si un cortafuegos bloquea las conexiones salientes directas, ejecuta swgbar bypass disable <domain> para restaurar de inmediato el enrutamiento normal por Zscaler.

Opción B: Configura herramientas CLI y de IA para confiar en Zscaler Root CA

Si tu política de red exige que el tráfico siga descifrado por Zscaler, exporta tu paquete PEM de Zscaler Root CA desde Acceso a Llaveros (o solicita el archivo PEM a TI) y configura tus entornos de ejecución en lugar de desactivar la verificación SSL:

# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"

Para ver instrucciones completas de entornos que cubren Homebrew, Docker Desktop, Python, Node.js, Claude Code y Cursor, lee Configurar confianza de CA para Homebrew, Docker, Python y Node.js y Solucionar errores de certificados de Claude Code y Cursor en macOS.