Source: https://swgbar.com/de/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: de

# 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 18\. November 2026

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](<https://swgbar.com/de/install/>) 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.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_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](<https://swgbar.com/de/guides/swg-bypass-vs-tls-exception/>).
*   **Autorisierte lokale Tests & Entwicklung**: In Netzwerken, die du verwaltest oder für Tests konfigurieren darfst, nutze die [domänenbasierte SWG-Umgehung](<https://swgbar.com/de/guides/how-to-bypass-swg/>) ü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](<https://swgbar.com/de/guides/swg-tls-certificate-errors-macos/>).

## 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/>)
*   [HTTPS- & TLS-Inspektion auf macOS umgehen (Break-and-Inspect-Anleitung)](<https://swgbar.com/de/guides/bypass-https-tls-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/>)
*   [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/>)
