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

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.
  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.

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. 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
  1. 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.
  2. 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.

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 o solicita a un administrador una regla Do Not Decrypt para el nombre de host exacto.