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

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.
  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- & 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 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
  1. 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.
  2. 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.

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 oder fordere bei der Administration eine Do Not Decrypt-Regel für den genauen Hostnamen an.