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

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 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.

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.
  • 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 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.