Source: https://swgbar.com/de/guides/zscaler-ssl-inspection-bypass-mac/
Language: de

# 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 19\. November 2026

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](<https://swgbar.com/de/install/>) (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** durch `Zscaler 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](<https://swgbar.com/de/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>), 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, und `sudo 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](<https://swgbar.com/de/guides/how-to-bypass-swg/>)) |
| **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](<https://swgbar.com/de/guides/swg-bypass-vs-tls-exception/>)) |
| **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)

1.  Ö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](<https://swgbar.com/de/guides/multi-domain-sso-api-cdn-swg-bypass/>)) und klicke neben **SWG umgehen** auf **Umgehung für diese Domain aktivieren** – oder führe `swgbar bypass enable <domain>` aus.
2.  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.
3.  Bestätige mit `swgbar probe <domain>`, dass nun die öffentliche Zertifikatskette des Ursprungsservers zurückgegeben wird. Blockiert eine Firewall direkte ausgehende Verbindungen, führe `swgbar 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](<https://swgbar.com/de/guides/homebrew-docker-python-node-ca-trust-swg-macos/>) sowie [Zertifikatsfehler in Claude Code & Cursor auf macOS beheben](<https://swgbar.com/de/guides/ai-coding-agents-claude-code-cursor-swg-macos/>).

## Weiterlesen

*   [SWG auf dem Mac umgehen (1-Klick-Domain-Umgehung & CLI)](<https://swgbar.com/de/guides/how-to-bypass-swg/>)
*   [SSL-Inspektion auf dem Mac umgehen (Unternehmens-SWG & Domain-Fix)](<https://swgbar.com/de/guides/bypass-ssl-inspection-mac/>)
*   [HTTPS- & TLS-Inspektion auf macOS umgehen (Break-and-Inspect-Anleitung)](<https://swgbar.com/de/guides/bypass-https-tls-inspection-mac/>)
*   [Unternehmensproxy & SWG-SSL-Inspektion auf dem Mac umgehen](<https://swgbar.com/de/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [So erkennst du, ob dein Mac von einem SWG abgefangen wird (HTTPS- & SSL-Inspektion)](<https://swgbar.com/de/guides/detect-https-inspection/>)
*   [Prüfen, ob dein Arbeitgeber oder Arbeits-Mac HTTPS abfängt (SSL-Inspektion)](<https://swgbar.com/de/guides/check-if-work-mac-intercepting-https/>)
*   [SSL-Inspektions-Checker für Mac: Menüleisten-Tool zur HTTPS-Erkennung](<https://swgbar.com/de/guides/ssl-inspection-checker-mac/>)
*   [Netskope SSL-Inspektion auf dem Mac: Entschlüsselung prüfen & pro Domain umgehen](<https://swgbar.com/de/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Cloudflare WARP & Zero Trust TLS-Inspektion auf dem Mac: Erkennen & umgehen](<https://swgbar.com/de/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Bestätigte vs. vermutete HTTPS-Inspektion in SWG bar](<https://swgbar.com/de/guides/confirmed-vs-suspected-https-inspection/>)
*   [Man-in-the-Middle-Root-Zertifikate & Aussteller in SWG bar prüfen](<https://swgbar.com/de/guides/inspect-mitm-root-certificates-macos/>)
*   [Enterprise-SWG- & MDM-HTTPS-Inspektion auf dem Mac](<https://swgbar.com/de/guides/enterprise-swg-https-inspection-macos/>)
*   [SWG-Umgehung vs. TLS-Inspektionsausnahme (Break-and-Inspect)](<https://swgbar.com/de/guides/swg-bypass-vs-tls-exception/>)
*   [SWG-Umgehung für Multi-Domain-Web-Apps, SSO, CDNs & APIs auf dem Mac](<https://swgbar.com/de/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [SWG-Umgehung „Wiederherstellung…“, „Umgehung pausiert“ & Verbindungsfehler auf dem Mac beheben](<https://swgbar.com/de/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Virtuelle VPN-Schnittstellen unter macOS vs. SWG-HTTPS-Inspektion](<https://swgbar.com/de/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Warum Apps mit Certificate Pinning & mTLS bei SWG-Inspektion fehlschlagen](<https://swgbar.com/de/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools auf dem Mac beheben](<https://swgbar.com/de/guides/swg-tls-certificate-errors-macos/>)
*   [Homebrew, Docker, Python & Node.js CA-Vertrauen hinter einem SWG auf dem Mac](<https://swgbar.com/de/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Claude Code & Cursor 'unable to get local issuer certificate' auf Mac beheben (SWG & MCP)](<https://swgbar.com/de/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [TLS-Zertifikate mit openssl & security verify-cert auf dem Mac verifizieren](<https://swgbar.com/de/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [SWG bar-Berechtigungen, lokaler Datenschutz & TLS-Prüflimits](<https://swgbar.com/de/guides/macos-network-extension-privacy-probe-limits/>)
*   [So prüft SWG bar HTTPS-Inspektion](<https://swgbar.com/de/how-it-works/>)
*   [SWG bar für Mac herunterladen & installieren (macOS 14+)](<https://swgbar.com/de/install/>)
*   [Chrome-Erweiterung zur Erkennung von SSL- & HTTPS-Inspektion (SWG Bar Companion)](<https://swgbar.com/de/chrome-extension/>)
*   [SWG bar CLI-Anleitung](<https://swgbar.com/de/cli/>)
*   [SWG bar MCP-Anleitung](<https://swgbar.com/de/mcp/>)
*   [Release-Informationen zu SWG bar](<https://swgbar.com/de/releases/>)
*   [Über SWG bar](<https://swgbar.com/de/about/>)
