Warum Apps mit Certificate Pinning & mTLS bei SWG-Inspektion fehlschlagen

Verstehe, weshalb Apps mit TLS Certificate Pinning oder Mutual TLS (mTLS) hinter einem Unternehmens-SWG mit HTTPS Break-and-Inspect auf macOS scheitern, selbst wenn MDM der Root-CA vertraut.

SWG bar · Aktualisiert

Auf per MDM verwalteten Macs fällt Mitarbeitenden häufig auf, dass normale Websites hinter einem Secure Web Gateway (SWG) problemlos funktionieren, während bestimmte Desktop-Apps, Sicherheits-Updater, mobile SDKs oder Entwickler-APIs sofort beim TLS-Handshake scheitern. In den meisten Fällen kollidiert dabei Certificate Pinning oder Mutual TLS (mTLS) mit HTTPS-/SSL-Break-and-Inspect des SWG.

Warum MDM-Stammvertrauen Certificate Pinning nicht behebt

Beim regulären Surfen vertrauen Safari und Chrome jeder gültigen Zertifikatskette, die auf einer Zertifizierungsstelle im macOS-Schlüsselbund basiert – einschließlich per MDM ausgerollter Unternehmens-Root-CAs.

Anwendungen mit TLS Certificate Pinning (HPKP- / SPKI-Pinning) gehen einen Schritt weiter: Sie betten den erwarteten Hash des öffentlichen Schlüssels (SPKI) oder das Blatt- bzw. Zwischenzertifikat fest in das Programm ein. Wenn ein Unternehmens-SWG TLS terminiert und das Zertifikat mit seiner eigenen Root-CA neu signiert:

  1. Stuft der macOS-Schlüsselbund das SWG-Zertifikat als gültig ein.
  2. Vergleicht die gepinnte Anwendung den Fingerabdruck des öffentlichen Schlüssels im SWG-Zertifikat mit ihrem eincompilierten Pin.
  3. Stimmen beide Fingerabdrücke nicht überein – also bricht die Anwendung den TLS-Handshake sofort ab, um sich vor Man-in-the-Middle-Interzeption zu schützen.

Warum Mutual TLS (mTLS) bei Break-and-Inspect fehlschlägt

Bei Mutual TLS (mTLS) authentifizieren sich beide Seiten: Der Client legt dem Zielserver ein Client-Zertifikat vor, bevor Zugriff gewährt wird (üblich bei Banking-APIs, B2B-Schnittstellen, Zero-Trust-APIs und hardwaregestützten Entwicklerdiensten).

Steht ein SWG dazwischen und terminiert die TLS-Verbindung, um HTTP-Nutzdaten zu entschlüsseln, sieht der Ursprungsserver nur die Verbindung des SWG statt des Client-TLS-Handshakes deines Mac – die Ende-zu-Ende-Prüfung des Client-Zertifikats schlägt fehl, sofern das Gateway den Host nicht rein verschlüsselt durchleitet oder ausnimmt.

Ermitteln, welche Hostnamen auf deinem Mac abgefangen werden

Bevor du bei der IT eine Gateway-Regel beantragst oder lokal eine Regel anlegst, bestimme zunächst genau den Hostnamen, den die gepinnte oder mTLS-App kontaktiert:

  1. Öffne SWG bar und reproduziere den Verbindungsfehler in deiner App.
  2. Prüfe SWG bar → Domains (oder führe swgbar domains list --status confirmed aus), um den exakten API-, CDN- oder Update-Hostnamen zu finden, den diese Anwendung anspricht.
  3. Öffne die Domain-Details und den Reiter Zertifikate, um zu bestätigen, ob die Unternehmens-SWG-Root-CA TLS für diesen Host terminiert.
Reiter Zertifikate in SWG bar mit Root-CAs und Anzahl zugeordneter Domains; illustrative Vorschau.

Prüfe in SWG bar, ob der API- oder Update-Hostname einer App unter einem Inspektions-CA-Cluster erscheint.

Die passende Lösung wählen

  • Produktiv- / verwaltete Unternehmensumgebungen: Beantrage bei deiner IT- oder Sicherheitsadministration eine gezielte TLS-Inspektionsausnahme (Do-Not-Decrypt-Regel) für den gepinnten oder mTLS-Hostnamen, damit das Gateway-Routing bestehen bleibt, ohne TLS Pinning zu brechen. Siehe SWG-Umgehung vs. TLS-Inspektionsausnahme.
  • Autorisierte lokale Tests & Entwicklung: In Netzwerken, die du verwaltest oder für Tests konfigurieren darfst, nutze die domänenbasierte SWG-Umgehung über Domains oder swgbar bypass enable <domain>, damit genau dieser Hostname ohne Gateway-Entschlüsselung verbindet.
  • CA-Speicher-Fehler in CLI- & KI-Laufzeiten: Handelt es sich nicht um striktes Pinning, sondern ignorieren git, npm, Python, Claude Code oder Cursor den macOS-Schlüsselbund, folge SWG-TLS- & SSL-Zertifikatsfehler in CLI- und KI-Tools auf dem Mac beheben.