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

# Cómo evitar la inspección HTTPS y TLS en macOS (guía de break-and-inspect)

Evita el descifrado break-and-inspect HTTPS y TLS en macOS por dominio con SWG bar: cómo la terminación TLS rompe HTTP/2, QUIC y el pinning, además de verificación por CLI.

SWG bar · Actualizado 19 de noviembre de 2026

Para evitar la **inspección HTTPS o TLS (break-and-inspect)** para un dominio concreto en macOS sin desactivar globalmente tu cliente de seguridad, abre **SWG bar → Dominios**, selecciona el nombre de host y activa **Evitar SWG** (o ejecuta `swgbar bypass enable <domain>`). Espera a que la fila muestre **Evasión activa** y luego reinicia la pestaña del navegador, el IDE o la sesión de CLI para establecer un handshake TLS nuevo por la interfaz física IPv4 `Hardware` de tu Mac.

Las pasarelas web seguras (SWG) corporativas y los cortafuegos de nueva generación inspeccionan el tráfico HTTPS actuando como un intermediario (_man-in-the-middle_) de confianza: terminan el handshake TLS 1.2/1.3 saliente de tu Mac, inspeccionan las cargas útiles HTTP descifradas y vuelven a cifrar el tráfico hacia el servidor de origen. Aunque los navegadores aceptan en silencio la CA raíz de la pasarela instalada por MDM, los protocolos modernos y los clientes de desarrollo estrictos fallan con frecuencia bajo la refirma TLS.

## Qué rompe realmente el break-and-inspect HTTPS/TLS en un Mac

Incluso cuando tu Mac confía en el certificado raíz corporativo en el Llavero, la terminación TLS en línea interrumpe cuatro flujos de trabajo habituales en macOS:

1.  **Certificate pinning y TLS mutuo (mTLS)**: Las aplicaciones que fijan la clave pública del servidor de origen o presentan un certificado de cliente abortan el handshake en cuanto una pasarela sustituye el certificado final por uno propio. Consulta [Certificate pinning y mTLS bajo inspección SWG](<https://swgbar.com/es/guides/certificate-pinning-mtls-swg-inspection-macos/>).
2.  **HTTP/3 (QUIC) y flujos persistentes HTTP/2 o WebSocket**: Las pasarelas que degradan o intermedian conexiones TLS suelen descartar flujos UDP QUIC, congelar respuestas en _streaming_ de LLM o restablecer canales persistentes de IDE/WebSocket.
3.  **Almacenes de CA independientes en CLI y lenguajes**: Entornos como `Node.js`, `Python`, `Git`, `Homebrew`, `Docker`, `Claude Code` y `Cursor` incluyen sus propios almacenes de CA raíz y fallan con `CERTIFICATE_VERIFY_FAILED` o `UNABLE_TO_GET_ISSUER_CERT_LOCALLY`.
4.  **APIs de desarrollo sensibles a la latencia**: Redirigir cada handshake TLS a través de un PoP distante de una SWG en la nube añade sobrecarga de ida y vuelta a las instalaciones de paquetes, descargas de git y autocompletado de código en tiempo real.

## Evasión TLS por dominio frente a ajustes locales de proxy y excepciones de pasarela

| Aspecto | Evasión por dominio (`SWG bar`) | Excepción administrativa de inspección TLS (`Do Not Decrypt`) | Ajustes locales de proxy (`Ajustes del Sistema → Proxies`) |
| --- | --- | --- | --- |
| **Capa** | Enrutamiento físico IPv4 por nombre de host mediante NetworkExtension de macOS | Política central de descifrado de la SWG / cortafuegos | Solo campos explícitos de proxy HTTP/HTTPS del SO |
| **¿Funciona frente a SWG transparentes?** | Sí, cuando hay una ruta física IPv4 alcanzable | Sí (configurada por TI) | No: los agentes SWG `utun` / transparentes los ignoran o sobrescriben |
| **¿Requiere consola de administración de TI?** | No (control local en un Mac autorizado) | Sí (portal de administración de Zscaler, Netskope, Cloudflare, Palo Alto) | No |
| **¿Preserva la postura del dispositivo / SSO?** | Sí: el agente corporativo de endpoint sigue en ejecución | Sí | Suele romper el enrutamiento PAC corporativo |

Para un análisis arquitectónico detallado entre cambios de ruta y exclusiones de descifrado en pasarela, consulta [Bypass de SWG frente a excepción de inspección TLS](<https://swgbar.com/es/guides/swg-bypass-vs-tls-exception/>).

## Evita la inspección HTTPS y TLS para un dominio en macOS

1.  **Identifica cada nombre de host inspeccionado**: Abre **SWG bar → Dominios** o ejecuta `swgbar domains list --status confirmed` mediante la [CLI](<https://swgbar.com/es/cli/>). Recuerda que `example.com`, `auth.example.com` y `api.example.com` son nombres de host independientes.
2.  **Activa la evasión por dominio**: Pulsa **Activar evasión para este dominio** en la fila **Evitar SWG** del dominio, o ejecuta:

```
swgbar bypass enable api.example.com
swgbar bypass status
```

3.  **Cierra conexiones TLS y HTTP/3 agrupadas**: Actualizar una sola pestaña del navegador puede reutilizar un socket agrupado HTTP/2 o QUIC de la ruta inspeccionada. La evasión nativa de SWG bar hace retroceder HTTP/3 a HTTPS sobre TCP en conexiones nuevas, así que recarga la pestaña o cierra por completo y vuelve a abrir la aplicación cuando aparezca **Evasión activa**.
4.  **Verifica la nueva cadena de certificados**: Ejecuta `swgbar probe api.example.com` (o `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`) para comprobar que se devuelve el emisor público del servidor de origen.

Si aparece **Recuperando…** o **Evasión pausada** en lugar de **Evasión activa**, consulta [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/>).

## Desactiva la evasión o recurre a la confianza de CA cuando sea obligatorio

Vuelve a pulsar el control activo **Evitar SWG** —o ejecuta `swgbar bypass disable <domain>`— para devolver de inmediato un nombre de host al enrutamiento estándar por pasarela. Salir de SWG bar también detiene enseguida la evasión activa, conservando tus selecciones de nombres de host guardadas para el próximo inicio.

Si tu red bloquea el tráfico IPv4 saliente directo en el cortafuegos, desactiva la evasión y aplica [soluciones de confianza de CA para herramientas CLI y de IA](<https://swgbar.com/es/guides/swg-tls-certificate-errors-macos/>) o solicita a un administrador una regla **Do Not Decrypt** para el nombre de host exacto.

## 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 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 Zscaler en Mac: cómo comprobar y evitar por dominio](<https://swgbar.com/es/guides/zscaler-ssl-inspection-bypass-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/>)
