Source: https://swgbar.com/es/guides/zscaler-ssl-inspection-bypass-mac/
Language: es

# 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 19 de noviembre de 2026

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](<https://swgbar.com/es/install/>) (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](<https://swgbar.com/es/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>) 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](<https://swgbar.com/es/guides/how-to-bypass-swg/>)) |
| **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](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>)) |
| **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](<https://swgbar.com/es/guides/multi-domain-sso-api-cdn-swg-bypass/>)) 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](<https://swgbar.com/es/guides/homebrew-docker-python-node-ca-trust-swg-macos/>) y [Solucionar errores de certificados de Claude Code y Cursor en macOS](<https://swgbar.com/es/guides/ai-coding-agents-claude-code-cursor-swg-macos/>).

## Sigue leyendo

*   [Cómo evitar una SWG en Mac (evasión por dominio en 1 clic y CLI)](<https://swgbar.com/es/guides/how-to-bypass-swg/>)
*   [Cómo evitar la inspección SSL en un Mac (SWG corporativa y solución por dominio)](<https://swgbar.com/es/guides/bypass-ssl-inspection-mac/>)
*   [Cómo evitar la inspección HTTPS y TLS en macOS (guía de break-and-inspect)](<https://swgbar.com/es/guides/bypass-https-tls-inspection-mac/>)
*   [Cómo evitar un proxy corporativo y la inspección SSL de SWG en un Mac](<https://swgbar.com/es/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Cómo saber si tu Mac está interceptado por una SWG (inspección HTTPS y SSL)](<https://swgbar.com/es/guides/detect-https-inspection/>)
*   [Cómo saber si tu empresa o Mac de trabajo está interceptando HTTPS (inspección SSL)](<https://swgbar.com/es/guides/check-if-work-mac-intercepting-https/>)
*   [Comprobador de inspección SSL para Mac: herramienta de barra de menús para detectar interceptación HTTPS](<https://swgbar.com/es/guides/ssl-inspection-checker-mac/>)
*   [Inspección SSL de Netskope en Mac: comprobar descifrado y evitar por dominio](<https://swgbar.com/es/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspección TLS de Cloudflare WARP y Zero Trust en Mac: detectar y evitar](<https://swgbar.com/es/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspección HTTPS Confirmado frente a Sospechoso en SWG bar](<https://swgbar.com/es/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspeccionar certificados raíz MITM y emisores en SWG bar](<https://swgbar.com/es/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspección HTTPS de SWG corporativa y MDM en un Mac](<https://swgbar.com/es/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass de SWG frente a excepción de inspección TLS (break-and-inspect)](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>)
*   [Evitar SWG en aplicaciones web multidominio, SSO, CDN y APIs en Mac](<https://swgbar.com/es/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Solucionar Recuperando…, Evasión pausada y errores de conexión al evitar SWG en Mac](<https://swgbar.com/es/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuales VPN en macOS frente a inspección HTTPS de SWG](<https://swgbar.com/es/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Por qué las apps con certificate pinning y mTLS fallan bajo inspección SWG](<https://swgbar.com/es/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>)
*   [Confianza de CA para Homebrew, Docker, Python y Node.js detrás de una SWG en Mac](<https://swgbar.com/es/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Corregir 'unable to get local issuer certificate' en Claude Code y Cursor en Mac (SWG y MCP)](<https://swgbar.com/es/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Verificar certificados TLS con openssl y security verify-cert en Mac](<https://swgbar.com/es/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permisos de SWG bar, privacidad local y límites de sondeo TLS](<https://swgbar.com/es/guides/macos-network-extension-privacy-probe-limits/>)
*   [Cómo comprueba SWG bar la inspección HTTPS](<https://swgbar.com/es/how-it-works/>)
*   [Descargar e instalar SWG bar para Mac (macOS 14+)](<https://swgbar.com/es/install/>)
*   [Extensión de Chrome para detectar inspección SSL y HTTPS (complemento de SWG bar)](<https://swgbar.com/es/chrome-extension/>)
*   [Guía de SWG bar CLI](<https://swgbar.com/es/cli/>)
*   [Guía de SWG bar MCP](<https://swgbar.com/es/mcp/>)
*   [Información de versiones de SWG bar](<https://swgbar.com/es/releases/>)
*   [Acerca de SWG bar](<https://swgbar.com/es/about/>)
