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_BUNDLEohttp.sslCAInfosegún las directrices de seguridad de TI. Nunca desactives la verificación TLS (NODE_TLS_REJECT_UNAUTHORIZED=0osslVerify=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.