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

# HTTPS- & TLS-Inspektion auf macOS umgehen (Break-and-Inspect-Anleitung)

Umgehe HTTPS- und TLS-Break-and-Inspect-Entschlüsselung auf macOS pro Domain mit SWG bar: wie TLS-Terminierung HTTP/2, QUIC und Pinning stört, plus CLI-Prüfung.

SWG bar · Aktualisiert 19\. November 2026

Um eine **HTTPS- oder TLS-Inspektion (Break-and-Inspect)** für eine bestimmte Domain auf macOS zu umgehen, ohne deinen Sicherheits-Client global zu deaktivieren, öffne **SWG bar → Domains**, wähle den Hostnamen aus und aktiviere **SWG umgehen** (oder führe `swgbar bypass enable <domain>` aus). Warte, bis in der Zeile **Umgehung aktiv** erscheint, und starte anschließend den Browser-Tab, die IDE oder die CLI-Sitzung neu, damit ein frischer TLS-Handshake über die physische `Hardware`\-IPv4-Schnittstelle deines Mac aufgebaut wird.

Enterprise Secure Web Gateways (SWGs) und Next-Generation-Firewalls inspizieren HTTPS-Verkehr, indem sie als vertrauenswürdiger Man-in-the-Middle agieren: Sie terminieren den ausgehenden TLS-1.2/1.3-Handshake deines Mac, prüfen die entschlüsselten HTTP-Nutzdaten und verschlüsseln den Verkehr zum Zielserver erneut. Während Browser die per MDM installierte Root-CA des Gateways stillschweigend akzeptieren, scheitern moderne Protokolle und strikte Entwickler-Clients häufig an der TLS-Neusignierung.

## Was HTTPS-/TLS-Break-and-Inspect auf einem Mac tatsächlich stört

Selbst wenn dein Mac dem Unternehmens-Wurzelzertifikat im Schlüsselbund vertraut, beeinträchtigt Inline-TLS-Terminierung vier häufige macOS-Workflows:

1.  **Certificate Pinning und gegenseitiges TLS (mTLS)**: Apps, die den öffentlichen Schlüssel des Zielservers fest verdrahten (Pinning) oder ein Client-Zertifikat vorweisen, brechen den Handshake sofort ab, sobald ein Gateway sein eigenes Blattzertifikat unterschiebt. Siehe [Certificate Pinning und mTLS unter SWG-Inspektion](<https://swgbar.com/de/guides/certificate-pinning-mtls-swg-inspection-macos/>).
2.  **HTTP/3 (QUIC) sowie langlebige HTTP/2- oder WebSocket-Streams**: Gateways, die TLS-Verbindungen herabstufen oder über Proxys leiten, verwerfen oft UDP-QUIC-Streams, lassen gestreamte LLM-Antworten einfrieren oder setzen dauerhafte IDE-/WebSocket-Kanäle zurück.
3.  **Eigene CA-Speicher von CLI-Tools und Laufzeitumgebungen**: Runtimes wie `Node.js`, `Python`, `Git`, `Homebrew`, `Docker`, `Claude Code` und `Cursor` bringen eigene Root-CA-Bundles mit und schlagen mit `CERTIFICATE_VERIFY_FAILED` oder `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` fehl.
4.  **Latenzkritische Entwickler-APIs**: Das Umleiten jedes einzelnen TLS-Handshakes über einen entfernten Cloud-SWG-PoP sorgt für spürbaren Round-Trip-Overhead bei Paketinstallationen, Git-Fetches und Code-Vervollständigung in Echtzeit.

## Domänenbasierte TLS-Umgehung vs. lokale Proxy-Einstellungen und Gateway-Ausnahmen

| Aspekt | Domänenbasierte Umgehung (`SWG bar`) | Administrative TLS-Inspektionsausnahme (`Do Not Decrypt`) | Lokale Proxy-Änderungen (`Systemeinstellungen → Proxies`) |
| --- | --- | --- | --- |
| **Ebene** | Physisches IPv4-Routing auf Hostnamen-Ebene über macOS NetworkExtension | Zentrale Entschlüsselungsrichtlinie im SWG / in der Firewall | Nur explizite HTTP-/HTTPS-Proxy-Felder des Betriebssystems |
| **Funktioniert bei transparenten SWGs?** | Ja, sofern ein physischer IPv4-Pfad erreichbar ist | Ja (von der IT konfiguriert) | Nein – wird von `utun`\- oder transparenten SWG-Agenten ignoriert oder überschrieben |
| **IT-Admin-Konsole erforderlich?** | Nein (lokale Steuerung auf einem autorisierten Mac) | Ja (Zscaler-, Netskope-, Cloudflare- oder Palo-Alto-Admin-Portal) | Nein |
| **Erhält Device Posture / SSO?** | Ja – der Unternehmens-Endpunkt-Agent läuft weiter | Ja | Stört häufig das Unternehmens-PAC-Routing |

Für einen detaillierten Architekturvergleich zwischen Routenänderungen und Gateway-Entschlüsselungsausnahmen lies [SWG-Umgehung vs. TLS-Inspektionsausnahme](<https://swgbar.com/de/guides/swg-bypass-vs-tls-exception/>).

## HTTPS- & TLS-Inspektion für eine Domain unter macOS umgehen

1.  **Alle inspizierten Hostnamen ermitteln**: Öffne **SWG bar → Domains** oder führe `swgbar domains list --status confirmed` über die [CLI](<https://swgbar.com/de/cli/>) aus. Bedenke, dass `example.com`, `auth.example.com` und `api.example.com` getrennte Hostnamen sind.
2.  **Domänenbasierte Umgehung aktivieren**: Klicke in der Zeile **SWG umgehen** der Domain auf **Umgehung für diese Domain aktivieren** oder führe Folgendes aus:

```
swgbar bypass enable api.example.com
swgbar bypass status
```

3.  **Gepoolte TLS- und HTTP/3-Verbindungen schließen**: Das bloße Neuladen eines einzelnen Browser-Tabs kann einen bereits offenen HTTP/2- oder QUIC-Socket des inspizierten Pfads weiterverwenden. Die native Umgehung von SWG bar schaltet HTTP/3 bei neuen Verbindungen auf HTTPS über TCP zurück – lade den Tab daher neu oder beende die Ziel-App und öffne sie erneut, sobald **Umgehung aktiv** erscheint.
4.  **Frische Zertifikatskette verifizieren**: Führe `swgbar probe api.example.com` aus (oder `openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null`), um sicherzustellen, dass der öffentliche Aussteller des Ursprungsservers zurückgegeben wird.

Erscheint statt **Umgehung aktiv** der Zustand **Wiederherstellung…** oder **Umgehung pausiert**, lies [SWG-Umgehung „Wiederherstellung…“, „Umgehung pausiert“ & Verbindungsfehler auf dem Mac beheben](<https://swgbar.com/de/guides/troubleshoot-swg-bypass-recovering-paused-macos/>).

## Umgehung wieder ausschalten oder bei Bedarf auf CA-Vertrauen ausweichen

Klicke erneut auf die aktive Steuerung in der Zeile **SWG umgehen** – oder führe `swgbar bypass disable <domain>` aus –, um einen Hostnamen sofort wieder auf das reguläre Gateway-Routing zurückzustellen. Auch das Beenden von SWG bar stoppt jede aktive Umgehung umgehend, behält deine gespeicherte Hostnamen-Auswahl jedoch für den nächsten Start bei.

Blockiert dein Netzwerk direkten ausgehenden IPv4-Verkehr auf Firewall-Ebene, deaktiviere die Umgehung und nutze [CA-Vertrauenslösungen für CLI- und KI-Tools](<https://swgbar.com/de/guides/swg-tls-certificate-errors-macos/>) oder fordere bei der Administration eine **Do Not Decrypt**\-Regel für den genauen Hostnamen an.

## 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/>)
*   [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/>)
*   [Zscaler SSL-Inspektion auf dem Mac: Pro Domain prüfen & umgehen](<https://swgbar.com/de/guides/zscaler-ssl-inspection-bypass-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/>)
