Inspección SSL de Netskope en Mac: comprobar descifrado y evitar por dominio

Comprueba si Netskope Client descifra HTTPS en tu Mac (CA *.goskope.com), compara la evasión por dominio con SWG bar frente a la política Do Not Decrypt y configura nscacert_combined.pem.

SWG bar · Actualizado

Para comprobar si Netskope Client está realizando descifrado SSL/TLS 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 un certificado de Netskope o del tenant *.goskope.com en Certificados de intermediario (MITM). Para evitar la inspección SSL de Netskope para un nombre de host específico en un Mac autorizado, abre SWG bar → Dominios, selecciona el nombre de host y pulsa Activar evasión para este dominio junto a Evitar SWG (o ejecuta swgbar bypass enable <domain>).

Netskope Secure Web Gateway está muy extendido en flotas corporativas de macOS mediante un cliente de desvío NetworkExtension y una CA intermedia específica por tenant. Como la CA raíz de Netskope se instala mediante MDM en el Llavero de macOS, los navegadores muestran indicadores de seguridad válidos mientras que los entornos CLI (pip, npm, AWS CLI, git, Docker, Claude Code) y las aplicaciones de escritorio con certificate pinning fallan con CERTIFICATE_VERIFY_FAILED o UNABLE_TO_GET_ISSUER_CERT_LOCALLY.

1. Verifica si Netskope está descifrando un dominio en tu Mac

Comprueba tanto la interceptación a nivel del sistema como los nombres de host individuales:

  • Visibilidad en la barra de menús y Chrome con SWG bar: Instala SWG bar (macOS 14+ con chip de Apple, prueba gratuita de 14 días de uso) y navega o ejecuta el comando que falla. Abre SWG bar → Dominios o ejecuta swgbar domains list --status confirmed para listar todos los nombres de host cuyo certificado TLS fue refirmado por la CA de tu tenant de Netskope (normalmente con un formato como ca.<tenant>.goskope.com o la CA personalizada de tu empresa). Combínalo con la extensión gratuita de Chrome de SWG bar para ver distintivos de estado en la barra de herramientas del navegador.
  • Comprueba certificados de Netskope y el emisor en vivo desde Terminal:
# Comprueba si hay una CA de Netskope instalada en el Llavero del sistema de macOS
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# Inspecciona el emisor del certificado en vivo devuelto para un nombre de host específico
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Recuerda que las políticas de Netskope suelen descifrar algunos dominios SaaS o de alojamiento de código mientras enrutan otros sin modificar; prueba siempre el nombre de host exacto que falla.

2. Por qué cerrar Netskope Client normalmente no funciona

En entornos administrados que tienen activada la política antimanipulación Protect Client configuration and resources de Netskope, la opción Disable del icono de Netskope en la barra de menús está deshabilitada o protegida con contraseña, y forzar la descarga del daemon interrumpe el enrutamiento de red del sistema. Borrar los campos de proxy del Wi-Fi en macOS tampoco surte efecto porque Netskope redirige el tráfico en la capa NetworkExtension de macOS.

3. Elige la solución adecuada para Netskope en macOS

Método ¿Detiene el descifrado de Netskope? ¿Requiere administrador del tenant de Netskope? Recomendado cuando
Evasión de SWG por dominio (SWG bar) Sí, para nombres de host seleccionados por IPv4 físico Hardware No (control local en un Mac autorizado) Una app con pinning, un WebSocket o un endpoint de desarrollo falla bajo el descifrado de Netskope y existe una ruta IPv4 directa (Cómo evitar una SWG en Mac)
Excepción Do Not Decrypt / Certificate Pinned Apps en el tenant de Netskope Sí, de forma centralizada en los Mac administrados Sí (Policies → SSL Decryption → Do Not Decrypt o Steering Configuration → Exceptions) Aplicaciones de escritorio con pinning o endpoints de desarrollo compartidos fallan para todo el equipo (Bypass de SWG frente a excepción TLS)
Paquete combinado de CA (nscacert_combined.pem) para herramientas CLI No (el tráfico sigue inspeccionado) No La política exige enrutamiento descifrado por Netskope y las herramientas CLI/IA solo necesitan confiar en la cadena de CA de Netskope

4. Aplica la evasión por dominio o configura la confianza de CA de Netskope para CLI

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

  1. Abre SWG bar → Dominios, selecciona el nombre de host inspeccionado exacto (por ejemplo api.anthropic.com o pypi.org) y pulsa Activar evasión para este dominio junto a Evitar SWG, o ejecuta swgbar bypass enable <domain>.
  2. Espera hasta que aparezca Evasión activa y luego reinicia la pestaña del navegador, la herramienta de terminal o el IDE para que las conexiones TLS/HTTP/3 agrupadas vuelvan a conectarse por la interfaz física IPv4 Hardware.
  3. Confirma con swgbar probe <domain> que ahora se sirve la cadena de certificados pública del origen. Para revertir de inmediato, pulsa el control activo o ejecuta swgbar bypass disable <domain>.

Opción B: Genera un paquete PEM combinado para herramientas CLI bajo Netskope

Si el tráfico debe seguir siendo inspeccionado por Netskope, exporta un paquete PEM combinado desde los almacenes de confianza de macOS (o utiliza el paquete nscacert_combined.pem facilitado por tu equipo de TI) y apunta tus herramientas de desarrollo hacia él en ~/.zshrc:

security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"

Consulta Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA y Confianza de CA para Homebrew, Docker, Python y Node.js para ver la configuración específica de cada herramienta.