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_BUNDLEoderhttp.sslCAInfogemäß IT-Sicherheitsvorgabe. Deaktiviere niemals die TLS-Verifizierung (NODE_TLS_REJECT_UNAUTHORIZED=0odersslVerify=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.