Homebrew, Docker, Python & Node.js CA-Vertrauen hinter einem SWG auf dem Mac

Warum Homebrew, Docker Desktop, Node.js, Python, git und curl von einem SWG signierte TLS-Zertifikate auf macOS ablehnen – und wie du CA-Bundles vs. SWG-Umgehung abwägst.

SWG bar · Aktualisiert

Auf einem Firmen-Mac hinter HTTPS Break-and-Inspect prüft jede Entwickler-Laufzeitumgebung TLS-Zertifikate anders. Während Safari und Chrome den macOS-Schlüsselbund abfragen, nutzen CLI-Werkzeuge und Container häufig eigene CA-Bundles – was zu plötzlichen Build-Fehlern über Paketmanager und SDKs hinweg führt.

Warum verschiedene Mac-Entwicklertools selektiv fehlschlagen

Werkzeug / Laufzeit Standard-Vertrauensspeicher auf macOS Typische Umgebungsvariable oder Einstellung
Node.js / npm / yarn / pnpm Einkompilierter Mozilla-CA-Speicher NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
Python / pip / uv / requests certifi-Bundle oder OpenSSL-CA-Pfad SSL_CERT_FILE / REQUESTS_CA_BUNDLE
git OpenSSL oder Secure Transport je nach Build git config --global http.sslCAInfo /path/to/corp-ca.pem
curl / Homebrew (brew) macOS Secure Transport oder OpenSSL-CA-Bundle HOMEBREW_CURLRC / CURL_CA_BUNDLE (curl --version prüfen)
Docker Desktop / Container Linux-VM & Image-/etc/ssl/certs (nicht macOS-Schlüsselbund) Unternehmens-CA zum Trust-Store der Docker-VM / des Images hinzufügen

1. Ermitteln, welcher Registry- oder API-Hostname inspiziert wird

Bevor du Shell-Profile oder Container-Builds änderst, verifiziere zunächst, welche exakten externen Hostnamen einer SSL-Inspektion unterliegen, statt aufgrund von DNS- oder Firewall-Blockaden zu scheitern:

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

Beachte, dass Paketmanager Downloads häufig über mehrere Hosts umleiten (zum Beispiel formulae.brew.sh → ghcr.io oder github.com → objects.githubusercontent.com). Siehe SWG-Umgehung für Multi-Domain-Web-Apps, SSO, CDNs & APIs.

2. Zwischen CA-Bundle, TLS-Ausnahme und SWG-Umgehung entscheiden

  • Unternehmens-Root-CA-PEM anhängen: Verlangt die Unternehmensrichtlinie für den gesamten Verkehr eine SWG-Entschlüsselung, exportiere exakt die unter SWG bar → Zertifikate identifizierte Root-CA und konfiguriere NODE_EXTRA_CA_CERTS, SSL_CERT_FILE, REQUESTS_CA_BUNDLE oder http.sslCAInfo gemäß IT-Sicherheitsvorgabe. Deaktiviere niemals die TLS-Verifizierung (NODE_TLS_REJECT_UNAUTHORIZED=0 oder sslVerify=false).
  • Administrative TLS-Inspektionsausnahme anfordern: Empfohlen für gemeinsam genutzte Registries, Docker-Basisimages oder Tools mit striktem Certificate Pinning, bei denen die Pflege eigener CA-Bundles zwischen CI und lokalen Rechnern fehleranfällig ist.
  • Domänenbasierte SWG-Umgehung in autorisierten Netzwerken nutzen: Wenn du bestimmte Hosts auf deinem Mac verwalten oder umgehen darfst, aktiviere SWG umgehen in SWG bar (oder swgbar bypass enable <domain>) und starte den CLI-Prozess neu.

Arbeitsabläufe vor Systemänderungen vergleichen

Eine Schritt-für-Schritt-Behebung für CERTIFICATE_VERIFY_FAILED findest du unter SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools auf dem Mac beheben. Um lokale Routing-Regeln mit Gateway-Richtlinienausnahmen zu vergleichen, lies SWG-Umgehung vs. TLS-Inspektionsausnahme.