Unternehmensproxy & SWG-SSL-Inspektion auf dem Mac umgehen
Warum das Deaktivieren der macOS-Systemeinstellungen-Proxies oder networksetup bei transparenten SWG-Proxys scheitert und wie Domain-Umgehung oder CLI-CA-Vertrauen funktionieren.
SWG bar · Aktualisiert
Wenn das Ausschalten der WLAN-Proxy-Schalter unter Systemeinstellungen → Netzwerk → Proxies – oder das Hinzufügen von Domains über networksetup -setproxybypassdomains – deinen Mac weiterhin hinter einer Unternehmensproxy-SSL-Inspektion belässt, nutzt dein Gerät statt eines einfachen expliziten HTTP-Proxys einen transparenten Secure-Web-Gateway-(SWG-)Agenten (NetworkExtension oder utun-Tunnel). Um die SWG-Inspektion für einen bestimmten 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 macOS-Proxy-Tutorials werfen zwei völlig unterschiedliche Unternehmensarchitekturen zusammen: klassische explizite Proxys / PAC-Dateien und moderne transparente SWG-Agenten (wie Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope oder Cloudflare Gateway). Sobald du weißt, welche Architektur dein Mac verwendet, wird sofort klar, warum übliche Proxy-Anpassungen wirkungslos bleiben – und welche Lösung wirklich funktioniert.
1. Prüfen, ob dein Mac einen expliziten Proxy oder ein transparentes SWG nutzt
Führe zwei schnelle Prüfungen durch, um zu sehen, wie der Datenverkehr unter macOS gelenkt wird:
- Explizite Systemproxy-Einstellungen prüfen:
scutil --proxy
Achte auf HTTPEnable : 1, HTTPSEnable : 1 oder ProxyAutoConfigURLString (eine .pac-URL). 2. Tatsächliche HTTPS-Zertifikatsinterzeption prüfen: Öffne SWG bar → Übersicht (oder führe swgbar overview / swgbar domains list --status confirmed aus).
- Ist
scutil --proxyleer, während SWG bar eine Domain-Inspektionsrate >0%meldet (mit Domains unter Bestätigt oder Verdacht sowie Man-in-the-Middle-Zertifikaten), steckt dein Mac hinter einem transparenten SWG-Agenten (NetworkExtension/utun), der Pakete unterhalb der macOS-Systemproxy-Einstellungen abfängt. - Listet
scutil --proxyeinen Unternehmensproxy oder eine PAC-Datei und zeigt SWG bar eine Unternehmens-MITM-Root-CA an, läuft der Verkehr über einen expliziten/PAC-basierten Inspektionsproxy.
2. Expliziter Proxy vs. transparenter SWG-Proxy unter macOS
| Architektur | Wo macOS den Verkehr abfängt | Umgehen Systemeinstellungen → Proxies / networksetup ihn? |
Was auf einem autorisierten Mac funktioniert |
|---|---|---|---|
| Expliziter HTTP-/HTTPS- oder PAC-Proxy (nicht verwaltet) | Proxy-Felder der macOS-Systemkonfiguration | Ja, sofern nicht per MDM gesperrt (Proxy-Einstellungen für diese Hosts und Domains nicht verwenden) |
macOS-Proxy-Ausnahmeliste oder Prüfung des Routings pro Domain |
Per MDM gesperrter expliziter Proxy oder transparentes SWG (NetworkExtension / utun) |
Kernel-/NetworkExtension-Socket- und IP-Filter unterhalb der Browser-Proxy-Schalter | Nein – Einstellungen sind gesperrt, werden überschrieben oder vom SWG-Tunnel vollständig ignoriert | Domänenbasierte physische Hardware-IPv4-Umgehung mit SWG bar (SWG auf dem Mac umgehen), IT-Gateway-Ausnahmen (External Domains / Do Not Decrypt) oder CLI-CA-Bundle-Konfiguration |
3. SWG-Proxy-SSL-Inspektion für eine bestimmte Domain auf macOS umgehen
Wenn eine bestimmte Web-App, ein API-Endpunkt oder ein Desktop-Client mit Certificate Pinning hinter einem Unternehmens-SWG-Proxy in einem Netzwerk fehlschlägt, das du verwaltest oder konfigurieren darfst:
- Installiere und öffne SWG bar (macOS 14+ mit Apple Chip, kostenlose Testphase für 14 Nutzungstage) und wiederhole die Anfrage, damit der genaue Hostname unter Domains erscheint.
- Öffne die Details des Hostnamens und klicke in der Zeile SWG umgehen auf Umgehung für diese Domain aktivieren – oder führe Folgendes aus:
swgbar bypass enable <domain>
swgbar bypass status
- Warte auf Umgehung aktiv und lade anschließend die Webseite neu oder starte den Terminal-/Desktop-Client neu, damit bestehende Keep-Alive-Sockets sich über die physische
Hardware-IPv4-Schnittstelle deines Mac (en0/en7) neu verbinden. - Verifiziere mit
swgbar probe <domain>, dass die öffentliche Zertifikatskette des Ursprungsservers sauber geliefert wird. Beachte: Wenn eine Anwendung eine eigene explizite Proxy-Einstellung fest vorgibt (etwaHTTP_PROXY/HTTPS_PROXYin~/.zshrc,~/.npmrcoder~/.gitconfig), entferne diese Proxy-Variablen für diesen Host, damit die App den Verkehr nicht wieder an den expliziten Proxy-Port zurückzwingt.
4. Wenn der Proxy nicht umgangen werden kann: IT-Ausnahmen & CLI-CA-Bundles
Blockiert deine Unternehmens-Firewall jeglichen direkten ausgehenden IPv4-Verkehr, der nicht durch den SWG-Proxy läuft (Fail-Closed-Perimeter):
- Domänenbasierte Umgehung deaktivieren (
swgbar bypass disable <domain>), damit der Hostname sofort zum normalen Proxy-Routing zurückkehrt. - CLI-Tools so konfigurieren, dass sie der Unternehmensproxy-CA vertrauen: Verweise
git,curl,npm,Python,Homebrew,Claude CodeundCursorauf deine exportierte Unternehmens-CA-PEM-Datei (SSL_CERT_FILE,NODE_EXTRA_CA_CERTS,REQUESTS_CA_BUNDLE,git http.sslCAInfo), statt unsicher die SSL-Prüfung abzuschalten. Siehe SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools beheben. - IT-Gateway-Umgehung / Entschlüsselungsausnahme beantragen: Übermittle der IT die genauen fehlschlagenden Hostnamen (einschließlich Login- und CDN-Domains) sowie die Zertifikatsnachweise aus SWG bar, damit zentral eine Do Not Decrypt- oder External Domains List-Regel eingetragen werden kann. Vergleiche beide Ebenen unter SWG-Umgehung vs. TLS-Inspektionsausnahme.