Zscaler SSL-Inspektion auf dem Mac: Pro Domain prüfen & umgehen
Prüfe, ob Zscaler Client Connector HTTPS auf deinem Mac entschlüsselt, warum das Beenden von ZCC am Manipulationsschutz scheitert, und nutze Domain-Umgehung oder CLI-CA-Vertrauen.
SWG bar · Aktualisiert
Um zu prüfen, ob Zscaler (ZIA / Zscaler Client Connector) HTTPS-Verkehr auf deinem Mac entschlüsselt, öffne SWG bar → Übersicht (oder führe swgbar overview aus) und prüfe, ob die Domain-Inspektionsrate über 0% liegt und unter Man-in-the-Middle-Zertifikate eine Zscaler Root CA oder eine Unternehmens-Zwischen-CA aufgeführt ist. Um die Zscaler-SSL-Inspektion für einen einzelnen fehlschlagenden Hostnamen auf einem autorisierten Mac zu umgehen, öffne SWG bar → Domains, wähle den Hostnamen aus und aktiviere SWG umgehen (oder führe swgbar bypass enable <domain> aus).
Die meisten Online-Anleitungen zum Umgehen von Zscaler gehen davon aus, dass du Zugang zum Zscaler Admin Portal (ZIA) hast. Auf einem über Jamf, Kandji oder Intune verwalteten Firmen-MacBook besitzen Entwickler und Mitarbeitende jedoch selten Portal-Zugriff – dennoch führen Zscalers Z-Tunnel 2.0 (NetworkExtension- / utun-Tunnel) und die Zscaler Root CA regelmäßig zu Fehlern bei Apps mit Certificate Pinning sowie bei Homebrew, npm, git, Python, Docker, Claude Code und Cursor.
1. Prüfen, ob Zscaler HTTPS auf deinem Mac aktiv inspiziert
Da MDM die Zscaler Root CA vorab im macOS-Schlüsselbund installiert und als vertrauenswürdig einstuft, zeigen Safari und Chrome selbst bei aktivem HTTPS Break-and-Inspect durch Zscaler ein normales Schlosssymbol. Verifiziere die Entschlüsselung pro Domain mit einer der folgenden Methoden:
- Kontinuierliche Prüfung mit SWG bar: Installiere SWG bar (macOS 14+ mit Apple Chip, kostenlose Testphase für 14 Nutzungstage) und besuche die betroffenen Websites. Öffne SWG bar → Domains oder Zertifikate – oder führe
swgbar probe <domain>aus –, um zu sehen, ob die Domain als Bestätigt durchZscaler Root CA(oder die Zscaler-Zwischen-CA deiner Firma) abgefangen wird oder über einen Öffentlicher Pfad läuft. - Einzelne Domain stichprobenartig im Terminal prüfen:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
Zeigt issuer= statt einer öffentlichen CA (wie DigiCert, Let’s Encrypt oder Google Trust Services) Zscaler oder die benutzerdefinierte Zscaler-Zwischen-CA deiner Organisation an, ist die Zscaler-SSL-Inspektion für diesen Hostnamen aktiv. Siehe TLS-Zertifikate mit OpenSSL und security verify-cert verifizieren, um SHA-256-Fingerabdrücke abzugleichen.
2. Warum das Abmelden oder Entladen von Zscaler Client Connector scheitert
Der Versuch, Zscaler auf einem verwalteten Mac global abzuschalten, geht fast immer nach hinten los:
- Manipulationsschutz (Tamper Protection): Die meisten ZCC-App-Profile in Unternehmen verlangen zum Abmelden oder Deaktivieren von Internet Security (
ZIA) ein Einmalpasswort der IT, undsudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.*wird blockiert oder sofort wieder neu gestartet. - Z-Tunnel 2.0 umgeht Systemproxy-Einstellungen: Das Deaktivieren der WLAN-HTTP-/HTTPS-Proxy-Schalter in den macOS-Systemeinstellungen hat keinerlei Auswirkung auf die Paketlenkung von Z-Tunnel 2.0.
- Unterbrochener Unternehmenszugang: Selbst wenn ZCC gestoppt wird, funktionieren interne ZPA-Apps (Zscaler Private Access) sowie per Device Posture abgesichertes SSO (
Okta,Entra ID) nicht mehr.
3. Drei praxistaugliche Wege für Zscaler-SSL-Inspektion auf macOS
| Ansatz | Wer kontrolliert ihn? | Lässt ZCC & Firmen-SSO weiterlaufen? | Bester Anwendungsfall |
|---|---|---|---|
Domänenbasierte SWG-Umgehung (SWG bar) |
Lokaler Mac-Nutzer (in autorisierten Netzwerken) | Ja – leitet nur den ausgewählten Hostnamen über die physische Hardware-IPv4-Schnittstelle deines Mac |
Sofortige Entlastung auf Hostnamen-Ebene für gepinnte Apps, WebSockets oder defekte Entwickler-APIs, ohne ZCC zu deaktivieren (SWG auf dem Mac umgehen) |
Zscaler-Admin-Portal-Ausnahme (Do Not Inspect / App Profile) |
Unternehmens-IT / Security-Team | Ja | Dauerhafte unternehmensweite Ausnahme unter Policy → SSL Inspection → Do Not Inspect oder macOS App Profiles → Hostname/IP Bypass (SWG-Umgehung vs. TLS-Ausnahme) |
| Zscaler Root CA exportieren & in CLI-Tools vertrauen | Lokaler Entwickler | Ja (Verkehr bleibt inspiziert) | Die Firmenrichtlinie verlangt entschlüsseltes Routing und git, npm, brew, Python, Claude Code oder Cursor scheitern mit unable to get local issuer certificate |
4. Domänenbasierte Umgehung aktivieren oder Zscaler Root CA für CLI-Tools einrichten
Option A: Domänenbasierte Umgehung mit SWG bar (sofern autorisiert)
- Öffne SWG bar → Domains, suche den genauen fehlschlagenden Hostnamen (beachte, dass Login-, API- und CDN-Domains getrennte Hostnamen sind – siehe SWG-Umgehung für Multi-Domain-Web-Apps, SSO, CDNs & APIs) und klicke neben SWG umgehen auf Umgehung für diese Domain aktivieren – oder führe
swgbar bypass enable <domain>aus. - Warte auf Umgehung aktiv und starte anschließend den Browser-Tab, die IDE oder die CLI-Sitzung neu, damit gepoolte Verbindungen über die direkte
Hardware-IPv4-Route neu aufgebaut werden. - Bestätige mit
swgbar probe <domain>, dass nun die öffentliche Zertifikatskette des Ursprungsservers zurückgegeben wird. Blockiert eine Firewall direkte ausgehende Verbindungen, führeswgbar bypass disable <domain>aus, um sofort zum normalen Zscaler-Routing zurückzukehren.
Option B: CLI- & KI-Tools für die Zscaler Root CA konfigurieren
Verlangt deine Netzwerkrichtlinie, dass der Verkehr weiterhin von Zscaler entschlüsselt wird, exportiere dein Zscaler-Root-CA-PEM-Bundle aus der Schlüsselbundverwaltung (oder fordere die PEM-Datei bei der IT an) und konfiguriere deine Laufzeitumgebungen, statt die SSL-Prüfung abzuschalten:
# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"
# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"
Vollständige Anleitungen für Homebrew, Docker Desktop, Python, Node.js, Claude Code und Cursor findest du unter CA-Vertrauen für Homebrew, Docker, Python und Node.js konfigurieren sowie Zertifikatsfehler in Claude Code & Cursor auf macOS beheben.