Netskope SSL-Inspektion auf dem Mac: Entschlüsselung prüfen & pro Domain umgehen

Prüfe, ob Netskope Client HTTPS auf deinem Mac entschlüsselt (*.goskope.com-CA), vergleiche SWG bar-Umgehung vs. Do-Not-Decrypt-Richtlinie und richte nscacert_combined.pem ein.

SWG bar · Aktualisiert

Um zu prüfen, ob der Netskope Client auf deinem Mac SSL-/TLS-Entschlüsselung durchführt, ö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 ein Netskope- oder *.goskope.com-Mandantenzertifikat erscheint. Um die Netskope-SSL-Inspektion für einen bestimmten Hostnamen auf einem autorisierten Mac zu umgehen, öffne SWG bar → Domains, wähle den Hostnamen aus und klicke neben SWG umgehen auf Umgehung für diese Domain aktivieren (oder führe swgbar bypass enable <domain> aus).

Netskope Secure Web Gateway ist in macOS-Unternehmensflotten weit verbreitet und kombiniert einen NetworkExtension-Steering-Client mit einer mandantenspezifischen Zwischen-CA. Da die Netskope-Root-CA per MDM in den macOS-Schlüsselbund ausgerollt wird, zeigen Browser ganz normale grüne bzw. gültige Sicherheitssymbole an, während CLI-Runtimes (pip, npm, AWS CLI, git, Docker, Claude Code) und Desktop-Apps mit Certificate Pinning mit CERTIFICATE_VERIFY_FAILED oder UNABLE_TO_GET_ISSUER_CERT_LOCALLY fehlschlagen.

1. Prüfen, ob Netskope eine Domain auf deinem Mac entschlüsselt

Prüfe sowohl die systemweite Interzeption als auch einzelne Hostnamen:

  • Sichtbarkeit in Menüleiste & Chrome mit SWG bar: Installiere SWG bar (macOS 14+ mit Apple Chip, kostenlose Testphase für 14 Nutzungstage) und rufe die Website auf oder führe den fehlschlagenden Befehl aus. Öffne SWG bar → Domains oder führe swgbar domains list --status confirmed aus, um jeden Hostnamen aufzulisten, dessen TLS-Zertifikat von deiner Netskope-Mandanten-CA neu signiert wurde (häufig benannt wie ca.<tenant>.goskope.com oder die benutzerdefinierte CA deiner Firma). Verbinde zusätzlich die kostenlose SWG bar Chrome-Erweiterung, um Status-Badges direkt in deiner Browser-Symbolleiste zu sehen.
  • Netskope-Zertifikate und Live-Aussteller im Terminal prüfen:
# Check whether a Netskope CA is installed in the macOS System Keychain
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# Inspect the live certificate issuer returned for a specific hostname
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Bedenke, dass Netskope-Richtlinien oft bestimmte SaaS- oder Code-Hosting-Domains entschlüsseln, während andere unangetastet weitergeleitet werden – teste immer genau den Hostnamen, der fehlschlägt.

2. Warum das Beenden von Netskope Client meistens nicht funktioniert

In verwalteten Umgebungen mit aktivierter Netskope-Manipulationsschutzrichtlinie (Protect Client configuration and resources) ist die Option Disable im Netskope-Menüleisten-Symbol deaktiviert oder passwortgeschützt, und das erzwungene Entladen des Daemons unterbricht das System-Netzwerkrouting. Auch das Leeren der macOS-WLAN-Proxy-Felder zeigt keine Wirkung, weil Netskope den Datenverkehr auf der macOS-NetworkExtension-Ebene steuert.

3. Die passende Netskope-Lösung auf macOS wählen

Methode Beendet Netskope-Entschlüsselung? Netskope-Tenant-Admin nötig? Am besten geeignet, wenn
Domänenbasierte SWG-Umgehung (SWG bar) Ja, für ausgewählte Hostnamen über physisches Hardware-IPv4 Nein (lokale Steuerung auf einem autorisierten Mac) Eine gepinnte App, ein WebSocket oder ein Entwickler-Endpunkt unter Netskope-Entschlüsselung fehlschlägt und ein direkter IPv4-Pfad existiert (SWG auf dem Mac umgehen)
Netskope-Tenant-Ausnahme (Do Not Decrypt / Certificate Pinned Apps) Ja, zentral auf allen verwalteten Macs Ja (Policies → SSL Decryption → Do Not Decrypt oder Steering Configuration → Exceptions) Unternehmensweite gepinnte Desktop-Apps oder gemeinsam genutzte Entwickler-Endpunkte für das gesamte Team fehlschlagen (SWG-Umgehung vs. TLS-Ausnahme)
Kombiniertes CA-Bundle (nscacert_combined.pem) für CLI-Tools Nein (Verkehr bleibt inspiziert) Nein Die Richtlinie verlangt entschlüsseltes Netskope-Routing und CLI-/KI-Tools müssen lediglich der Netskope-CA-Kette vertrauen

4. Domänenbasierte Umgehung anwenden oder Netskope-CLI-CA-Vertrauen konfigurieren

Option A: Domänenbasierte Umgehung mit SWG bar (sofern autorisiert)

  1. Öffne SWG bar → Domains, wähle den genauen inspizierten Hostnamen aus (zum Beispiel api.anthropic.com oder pypi.org) und klicke neben SWG umgehen auf Umgehung für diese Domain aktivieren – oder führe swgbar bypass enable <domain> aus.
  2. Warte, bis Umgehung aktiv erscheint, und starte anschließend den Browser-Tab, das Terminal-Tool oder die IDE neu, damit bestehende gepoolte TLS-/HTTP/3-Verbindungen über die physische Hardware-IPv4-Schnittstelle neu aufgebaut werden.
  3. Bestätige mit swgbar probe <domain>, dass nun die öffentliche Zertifikatskette des Ursprungsservers ausgeliefert wird. Zum sofortigen Zurücksetzen klicke erneut auf die aktive Steuerung oder führe swgbar bypass disable <domain> aus.

Option B: Kombiniertes PEM-Bundle für CLI-Tools unter Netskope erstellen

Muss der Datenverkehr weiterhin von Netskope inspiziert werden, exportiere ein kombiniertes PEM-Bundle aus deinen macOS-Vertrauensspeichern (oder nutze die von der IT bereitgestellte Datei nscacert_combined.pem) und verweise deine Entwicklertools in ~/.zshrc darauf:

security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"

Toolspezifische Anleitungen findest du unter SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools beheben sowie CA-Vertrauen für Homebrew, Docker, Python und Node.js.