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

# Pourquoi les apps à certificate pinning et mTLS cassent sous inspection SWG

Comprenez pourquoi les applications utilisant le TLS certificate pinning ou le TLS mutuel (mTLS) échouent derrière une SWG d’entreprise en break-and-inspect sur macOS même lorsque le MDM approuve la CA racine.

SWG bar · Mis à jour 18 novembre 2026

Les utilisateurs de Mac gérés par MDM constatent fréquemment que les sites web ordinaires fonctionnent sans difficulté derrière une passerelle web sécurisée (SWG) d’entreprise, tandis que certaines applications de bureau, outils de mise à jour de sécurité, SDK mobiles ou API de développement échouent immédiatement lors de la négociation TLS. Dans la plupart des cas, le problème vient d’un conflit entre le **certificate pinning** ou le **TLS mutuel (mTLS)** et le **break-and-inspect HTTPS/SSL** de la SWG.

## Pourquoi la confiance racine MDM ne corrige pas le certificate pinning

Lors d’une navigation HTTPS classique, Safari et Chrome font confiance à toute chaîne de certificats valide rattachée à une autorité présente dans le **Trousseau macOS**, y compris les CA racines d’entreprise déployées par MDM.

Les applications qui mettent en œuvre le **TLS certificate pinning (épinglage HPKP / SPKI)** vont plus loin : elles intègrent directement dans le binaire de l’application l’empreinte attendue de la clé publique (SPKI) ou le certificat terminal/intermédiaire. Lorsqu’une SWG d’entreprise termine la session TLS et resigne le certificat avec sa propre CA racine d’entreprise :

1.  Le Trousseau macOS indique que le certificat de la SWG est valide.
2.  L’application épinglée compare l’empreinte de clé publique du certificat SWG à son empreinte intégrée.
3.  Les empreintes ne correspondent pas — l’application interrompt aussitôt la négociation TLS pour se prémunir contre une interception man-in-the-middle.

## Pourquoi le TLS mutuel (mTLS) échoue lors du break-and-inspect

Avec le **TLS mutuel (mTLS)**, les deux extrémités s’authentifient : le client présente un certificat client au serveur d’origine avant d’obtenir l’accès (courant pour les API bancaires, points de terminaison B2B, API zero-trust et services développeurs protégés par matériel).

Si une SWG s’interpose et termine la connexion TLS pour déchiffrer les charges HTTP, le serveur d’origine voit la connexion de la passerelle plutôt que la négociation TLS cliente de votre Mac — ce qui rompt la validation de certificat client de bout en bout à moins que la passerelle n’agisse comme un simple relais chiffré ou n’exclue cet hôte.

## Diagnostiquer quels noms d’hôtes sont interceptés sur votre Mac

Avant de demander une règle de passerelle au service informatique ou de configurer une règle locale, identifiez le nom d’hôte exact contacté par l’application à pinning ou mTLS :

1.  Ouvrez [SWG bar](<https://swgbar.com/fr/install/>) et reproduisez l’échec de connexion dans votre application.
2.  Consultez **SWG bar → Domaines** (ou exécutez `swgbar domains list --status confirmed`) pour repérer le nom d’hôte exact d’API, de CDN ou de mise à jour contacté par cette application.
3.  Examinez les détails du domaine et l’onglet **Certificats** pour confirmer si la CA racine de la SWG d’entreprise termine la session TLS pour cet hôte.

![Onglet Certificats de SWG bar montrant les CA racines et le nombre de domaines associés ; aperçu illustratif.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_Vérifiez dans SWG bar si le nom d’hôte d’API ou de mise à jour d’une application apparaît sous un groupe d’autorités d’inspection._

## Choisir la solution appropriée

*   **Production / environnements d’entreprise gérés** : demandez à votre administrateur informatique ou sécurité une **exception d’inspection TLS (règle de non-déchiffrement)** ciblée pour le nom d’hôte à pinning ou mTLS afin de préserver le routage par la passerelle sans rompre le pinning TLS. Voir [Contournement de SWG vs exception d’inspection TLS](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>).
*   **Tests locaux et développement autorisés** : sur les réseaux que vous administrez ou êtes autorisé à tester, utilisez le [contournement de SWG par domaine](<https://swgbar.com/fr/guides/how-to-bypass-swg/>) depuis **Domaines** ou `swgbar bypass enable <domain>` afin que ce nom d’hôte se connecte sans déchiffrement par la passerelle.
*   **Erreurs de magasin CA dans les outils CLI et IA** : si l’échec ne provient pas d’un pinning strict, mais de `git`, `npm`, `Python`, `Claude Code` ou `Cursor` qui ignorent le Trousseau macOS, suivez [Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA sur Mac](<https://swgbar.com/fr/guides/swg-tls-certificate-errors-macos/>).

## Pour aller plus loin

*   [Comment contourner une SWG sur Mac (contournement par domaine en 1 clic et CLI)](<https://swgbar.com/fr/guides/how-to-bypass-swg/>)
*   [Comment contourner l’inspection SSL sur Mac (SWG d’entreprise et par domaine)](<https://swgbar.com/fr/guides/bypass-ssl-inspection-mac/>)
*   [Comment contourner l’inspection HTTPS et TLS sur macOS (guide break-and-inspect)](<https://swgbar.com/fr/guides/bypass-https-tls-inspection-mac/>)
*   [Comment contourner l’inspection SSL d’un proxy d’entreprise et d’une SWG sur Mac](<https://swgbar.com/fr/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Comment savoir si votre Mac est intercepté par une SWG (inspection HTTPS et SSL)](<https://swgbar.com/fr/guides/detect-https-inspection/>)
*   [Comment vérifier si votre employeur ou Mac professionnel intercepte HTTPS (inspection SSL)](<https://swgbar.com/fr/guides/check-if-work-mac-intercepting-https/>)
*   [Vérificateur d’inspection SSL pour Mac : outil de barre des menus pour détecter l’interception HTTPS](<https://swgbar.com/fr/guides/ssl-inspection-checker-mac/>)
*   [Inspection SSL Zscaler sur Mac : comment vérifier et contourner par domaine](<https://swgbar.com/fr/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [Inspection SSL Netskope sur Mac : vérifier le déchiffrement et contourner par domaine](<https://swgbar.com/fr/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspection TLS Cloudflare WARP et Zero Trust sur Mac : détecter et contourner](<https://swgbar.com/fr/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspection HTTPS Confirmé vs Suspecté dans SWG bar](<https://swgbar.com/fr/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspecter les certificats racines MITM et les émetteurs dans SWG bar](<https://swgbar.com/fr/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspection HTTPS par SWG d’entreprise et MDM sur Mac](<https://swgbar.com/fr/guides/enterprise-swg-https-inspection-macos/>)
*   [Contournement de SWG vs exception d’inspection TLS (break-and-inspect)](<https://swgbar.com/fr/guides/swg-bypass-vs-tls-exception/>)
*   [Contourner la SWG pour applications web multi-domaines, SSO, CDN et API sur Mac](<https://swgbar.com/fr/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Corriger Restauration…, Contournement en pause et erreurs de connexion SWG sur Mac](<https://swgbar.com/fr/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuelles VPN macOS vs inspection HTTPS d’une SWG](<https://swgbar.com/fr/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA sur Mac](<https://swgbar.com/fr/guides/swg-tls-certificate-errors-macos/>)
*   [Confiance CA Homebrew, Docker, Python et Node.js derrière une SWG sur Mac](<https://swgbar.com/fr/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Corriger 'unable to get local issuer certificate' dans Claude Code et Cursor sur Mac (SWG et MCP)](<https://swgbar.com/fr/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Vérifier les certificats TLS avec openssl et security verify-cert sur Mac](<https://swgbar.com/fr/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Autorisations de SWG bar, confidentialité locale et limites des sondes TLS](<https://swgbar.com/fr/guides/macos-network-extension-privacy-probe-limits/>)
*   [Comment SWG bar vérifie l’inspection HTTPS](<https://swgbar.com/fr/how-it-works/>)
*   [Télécharger et installer SWG bar pour Mac (macOS 14+)](<https://swgbar.com/fr/install/>)
*   [Extension Chrome pour détecter l’inspection SSL et HTTPS (compagnon SWG bar)](<https://swgbar.com/fr/chrome-extension/>)
*   [Guide de SWG bar CLI](<https://swgbar.com/fr/cli/>)
*   [Guide de SWG bar MCP](<https://swgbar.com/fr/mcp/>)
*   [Informations de version de SWG bar](<https://swgbar.com/fr/releases/>)
*   [À propos de SWG bar](<https://swgbar.com/fr/about/>)
