Contourner la SWG pour applications web multi-domaines, SSO, CDN et API sur Mac

Pourquoi contourner un seul domaine racine ne suffit pas pour les apps modernes : repérez les noms d’hôtes de connexion, CDN et API dans SWG bar et réinitialisez les connexions keep-alive.

SWG bar · Mis à jour

Une surprise fréquente après avoir activé Contourner la SWG sur macOS consiste à voir la page principale se recharger tandis que les redirections de connexion, images, téléchargements de paquets ou appels d’API subissent toujours l’inspection HTTPS ou échouent. Comme SWG bar applique les règles de contournement par nom d’hôte exact, les applications web multi-domaines et outils de développement dépendent souvent de plusieurs hôtes distincts.

Pourquoi le contournement d’un seul nom d’hôte ne couvre pas les sous-domaines

Activer le contournement sur app.example.com achemine uniquement app.example.com. Cela ne contourne pas automatiquement :

  • Fournisseurs d’authentification unique (SSO) et OAuth : login.example.com, auth.example.com, sso.company.com ou des hôtes d’identité tiers (accounts.google.com, login.microsoftonline.com).
  • Points de terminaison API et IA : api.example.com, graphql.example.com ou des sous-domaines distincts de télémétrie et de streaming.
  • Ressources statiques et registres : cdn.example.net, assets.example.com ou des compartiments de stockage objet (*.s3.amazonaws.com, objects.githubusercontent.com).

Notez également que les noms d’hôtes non identifiables ou chiffrés via SNI/ECH ne peuvent pas être mis en correspondance pour un contournement par domaine.

Identifier chaque nom d’hôte inspecté utilisé par une application

  1. Ouvrez le site web ou exécutez une fois le flux de développement en échec pendant que SWG bar surveille le trafic.
  2. Dans SWG bar → Domaines, triez ou filtrez par Confirmé / Suspecté et recherchez par mot-clé (par exemple example ou auth), ou interrogez via la CLI :
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
  1. Pour chaque nom d’hôte inspecté nécessaire au flux de travail, ouvrez ses détails et activez Contourner la SWG (ou exécutez swgbar bypass enable <hostname>).
  2. Gardez à l’esprit que contourner un domaine d’authentification ou d’API sur un réseau autorisé ne signifie pas que tous les autres domaines doivent être contournés : limitez les règles strictement aux hôtes qui l’exigent.

Fermer les connexions keep-alive et vérifier l’état dans Chrome

Même après l’apparition de Contournement actif, les navigateurs et démons d’arrière-plan réutilisent les sockets HTTP/2, HTTP/3 ou TLS keep-alive existants ouverts sur l’ancien chemin inspecté :

  • Navigateurs web : actualisez l’onglet concerné (Cmd + Shift + R), ou fermez puis rouvrez la fenêtre du navigateur si le site maintient des connexions WebSocket ou HTTP/3 persistantes. Utilisez l’extension complémentaire Chrome pour vérifier le nom d’hôte actif affiché pour l’onglet courant — tout en gardant à l’esprit que l’extension affiche des observations enregistrées par SWG bar sans lire le socket actif de Chrome.
  • Terminal et IDE : redémarrez les processus persistants (npm, démon Claude Code, serveurs de langage de l’IDE ou assistants d’identifiants git) afin qu’ils ouvrent de nouvelles connexions TCP/TLS via l’interface physique.

Vérifier chaque nom d’hôte séparément

Après avoir mis à jour les règles, ouvrez Domaines (ou exécutez swgbar domains detail <hostname>) et assurez-vous que des sondes récentes confirment la confiance publique pour chaque nom d’hôte de la chaîne, pas uniquement pour l’URL principale visible dans la barre d’adresse du navigateur. Si un domaine SaaS ou SSO utilisé à l’échelle de l’organisation affecte toute l’équipe, comparez dans Contournement de SWG vs exception d’inspection TLS si une exception de politique définie par l’administrateur est plus appropriée.