Confianza de CA para Homebrew, Docker, Python y Node.js detrás de una SWG en Mac

Por qué Homebrew, Docker Desktop, Node.js, Python, git y curl rechazan certificados TLS firmados por una SWG en macOS, y cómo elegir entre paquetes de CA o evitar la SWG.

SWG bar · Actualizado

En un Mac corporativo detrás de inspección HTTPS break-and-inspect, cada entorno de desarrollo valida los certificados TLS de forma distinta. Mientras Safari y Chrome consultan el Llavero de macOS, las herramientas CLI y los contenedores suelen usar sus propios almacenes de CA, provocando fallos repentinos en gestores de paquetes y SDK.

Por qué distintas herramientas de desarrollo en Mac fallan de forma selectiva

Herramienta / Entorno Almacén de confianza predeterminado en macOS Variable de entorno o ajuste habitual
Node.js / npm / yarn / pnpm Almacén Mozilla CA compilado NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
Python / pip / uv / requests Paquete certifi o ruta CA de OpenSSL SSL_CERT_FILE / REQUESTS_CA_BUNDLE
git OpenSSL o Secure Transport según compilación git config --global http.sslCAInfo /path/to/corp-ca.pem
curl / Homebrew (brew) Secure Transport de macOS o paquete CA de OpenSSL HOMEBREW_CURLRC / CURL_CA_BUNDLE (revisa curl --version)
Docker Desktop / Contenedores VM Linux e imagen /etc/ssl/certs (no Llavero de macOS) Añadir la CA corporativa al almacén de la VM / imagen Docker

1. Identifica qué nombre de host de registro o API está interceptado

Antes de editar perfiles de shell o compilaciones de contenedores, confirma qué nombres de host externos exactos sufren inspección SSL en lugar de fallar por bloqueos de DNS o cortafuegos:

swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io

Ten en cuenta que los gestores de paquetes suelen redirigir las descargas entre varios hosts (por ejemplo formulae.brew.sh → ghcr.io o github.com → objects.githubusercontent.com). Consulta Evitar SWG en aplicaciones web multidominio, SSO, CDN y APIs.

2. Decide entre configurar un paquete CA, excepción TLS o evitar SWG

  • Añadir el archivo PEM de la CA raíz corporativa: Cuando la política de empresa exige descifrado SWG para todo el tráfico, exporta la CA raíz exacta identificada en SWG bar → Certificados y configura NODE_EXTRA_CA_CERTS, SSL_CERT_FILE, REQUESTS_CA_BUNDLE o http.sslCAInfo según las directrices de seguridad de TI. Nunca desactives la verificación TLS (NODE_TLS_REJECT_UNAUTHORIZED=0 o sslVerify=false).
  • Solicitar una excepción de inspección TLS a TI: Recomendado para registros compartidos, imágenes base de Docker o herramientas con certificate pinning estricto donde mantener paquetes de CA propios entre CI y equipos locales resulta frágil.
  • Usar la evasión de SWG por dominio en redes autorizadas: Cuando administras o tienes autorización para evitar hosts específicos en tu Mac, activa Evitar SWG en SWG bar (o swgbar bypass enable <domain>) y reinicia el proceso de CLI.

Compara flujos antes de cambiar los valores predeterminados del sistema

Para resolver paso a paso errores CERTIFICATE_VERIFY_FAILED, lee Solucionar errores de certificados TLS y SSL de SWG en herramientas CLI y de IA en Mac. Para comparar reglas locales de enrutamiento con exclusiones de política en pasarela, revisa Bypass de SWG frente a excepción de inspección TLS.