Comment contourner l’inspection HTTPS et TLS sur macOS (guide break-and-inspect)
Contournez le déchiffrement HTTPS et TLS break-and-inspect sur macOS par domaine avec SWG bar : impact sur HTTP/2, QUIC et le pinning, plus la vérification CLI.
SWG bar · Mis à jour
Pour contourner l’inspection HTTPS ou TLS (break-and-inspect) pour un domaine précis sur macOS sans désactiver globalement votre client de sécurité, ouvrez SWG bar → Domaines, sélectionnez le nom d’hôte et activez Contourner la SWG (ou exécutez swgbar bypass enable <domain>). Attendez que la ligne affiche Contournement actif, puis redémarrez l’onglet du navigateur, l’IDE ou la session CLI afin qu’une nouvelle négociation TLS s’établisse sur l’interface physique IPv4 Matériel de votre Mac.
Les passerelles web sécurisées (SWG) d’entreprise et les pare-feu de nouvelle génération inspectent le trafic HTTPS en agissant comme un intermédiaire de confiance (man-in-the-middle) : ils terminent la négociation TLS 1.2/1.3 sortante de votre Mac, inspectent les charges HTTP déchiffrées, puis rechiffrent le trafic vers le serveur d’origine. Si les navigateurs acceptent silencieusement la CA racine de la passerelle installée via MDM, les protocoles modernes et les clients de développement stricts échouent fréquemment face à la resignature TLS.
Ce que le break-and-inspect HTTPS/TLS casse concrètement sur un Mac
Même lorsque votre Mac fait confiance au certificat racine d’entreprise dans le trousseau, la terminaison TLS en ligne perturbe quatre usages courants sur macOS :
- Certificate pinning et TLS mutuel (mTLS) : les applications qui épinglent la clé publique du serveur d’origine ou présentent un certificat client interrompent la négociation dès qu’une passerelle substitue son propre certificat feuille. Voir Certificate pinning et mTLS sous inspection SWG.
- HTTP/3 (QUIC) et flux persistants HTTP/2 ou WebSocket : les passerelles qui rétrogradent ou relayent les connexions TLS abandonnent souvent les flux UDP QUIC, bloquent les réponses LLM en streaming ou réinitialisent les canaux IDE/WebSocket persistants.
- Magasins CA indépendants des outils CLI et langages : les environnements tels que
Node.js,Python,Git,Homebrew,Docker,Claude CodeetCursorembarquent leurs propres magasins de CA racines et échouent avecCERTIFICATE_VERIFY_FAILEDouUNABLE_TO_GET_ISSUER_CERT_LOCALLY. - API de développement sensibles à la latence : acheminer chaque négociation TLS via un point de présence SWG cloud distant ajoute une latence aller-retour à l’installation de paquets, aux
git fetchet à la complétion de code en temps réel.
Contournement TLS par domaine vs réglages proxy locaux et exceptions de passerelle
| Critère | Contournement par domaine (SWG bar) |
Exception d’inspection TLS administrateur (Do Not Decrypt) |
Modifications proxy locales (Réglages Système → Proxys) |
|---|---|---|---|
| Couche | Routage IPv4 physique par nom d’hôte via macOS NetworkExtension | Politique centrale de déchiffrement SWG / pare-feu | Uniquement les champs explicites de proxy HTTP/HTTPS du système |
| Fonctionne face aux SWG transparentes ? | Oui, lorsqu’un chemin IPv4 physique est joignable | Oui (configuré par l’IT) | Non — ignoré ou écrasé par utun ou les agents SWG transparents |
| Console d’administration IT requise ? | Non (contrôle local sur un Mac autorisé) | Oui (portail d’administration Zscaler, Netskope, Cloudflare, Palo Alto) | Non |
| Préserve la posture de l’appareil / le SSO ? | Oui — l’agent de poste d’entreprise reste actif | Oui | Casse souvent le routage PAC d’entreprise |
Pour une comparaison d’architecture approfondie entre changement de routage et exclusions de déchiffrement côté passerelle, consultez Contournement de SWG vs exception d’inspection TLS.
Contourner l’inspection HTTPS et TLS pour un domaine sur macOS
- Identifier chaque nom d’hôte inspecté : ouvrez SWG bar → Domaines ou exécutez
swgbar domains list --status confirmedvia la CLI. Rappelez-vous queexample.com,auth.example.cometapi.example.comsont des noms d’hôte distincts. - Activer le contournement par domaine : cliquez sur Activer le contournement pour ce domaine dans la ligne Contourner la SWG du domaine, ou exécutez :
swgbar bypass enable api.example.com
swgbar bypass status
- Fermer les connexions TLS et HTTP/3 groupées : actualiser un seul onglet du navigateur peut réutiliser un socket HTTP/2 ou QUIC déjà ouvert sur le chemin inspecté. Le contournement natif de SWG bar bascule HTTP/3 vers HTTPS sur TCP pour les nouvelles connexions : rechargez donc l’onglet ou quittez puis rouvrez l’application cible une fois Contournement actif affiché.
- Vérifier la nouvelle chaîne de certificats : exécutez
swgbar probe api.example.com(ouopenssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null) pour confirmer que l’émetteur public du serveur d’origine est bien renvoyé.
Si Restauration… ou Contournement en pause s’affiche au lieu de Contournement actif, consultez Corriger Restauration…, Contournement en pause et erreurs de connexion SWG sur Mac.
Désactiver le contournement ou basculer sur la confiance CA si nécessaire
Cliquez de nouveau sur la commande active Contourner la SWG — ou exécutez swgbar bypass disable <domain> — pour renvoyer immédiatement un nom d’hôte vers le routage standard de la passerelle. Quitter SWG bar interrompt également tout contournement actif immédiatement tout en mémorisant votre sélection de noms d’hôte pour le lancement suivant.
Si votre réseau bloque le trafic IPv4 sortant direct au niveau du pare-feu, désactivez le contournement et appliquez les correctifs de confiance CA pour outils CLI et IA ou demandez à votre administrateur une règle Do Not Decrypt pour le nom d’hôte exact.