Inspection SSL Netskope sur Mac : vérifier le déchiffrement et contourner par domaine
Vérifiez si Netskope Client déchiffre HTTPS sur votre Mac (CA *.goskope.com), comparez le contournement SWG bar à la règle Do Not Decrypt et configurez nscacert_combined.pem.
SWG bar · Mis à jour
Pour vérifier si Netskope Client effectue un déchiffrement SSL/TLS sur votre Mac, ouvrez SWG bar → Vue d’ensemble (ou exécutez swgbar overview) et vérifiez si le Taux d’inspection des domaines dépasse 0% avec un certificat Netskope ou de locataire *.goskope.com dans Certificats d’interception (MITM). Pour contourner l’inspection SSL Netskope pour un nom d’hôte précis sur un Mac autorisé, ouvrez SWG bar → Domaines, sélectionnez le nom d’hôte et cliquez sur Activer le contournement pour ce domaine dans la ligne Contourner la SWG (ou exécutez swgbar bypass enable <domain>).
Netskope Secure Web Gateway est largement déployé sur les parcs macOS d’entreprise à l’aide d’un client de pilotage NetworkExtension et d’une CA intermédiaire propre au locataire. Comme la CA racine Netskope est poussée via MDM dans le trousseau macOS, les navigateurs affichent des indicateurs de sécurité verts/valides normaux alors que les runtimes CLI (pip, npm, AWS CLI, git, Docker, Claude Code) et les applications de bureau à certificate pinning échouent avec CERTIFICATE_VERIFY_FAILED ou UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
1. Vérifier si Netskope déchiffre un domaine sur votre Mac
Contrôlez à la fois l’interception à l’échelle du système et les noms d’hôte individuels :
- Visibilité barre des menus et Chrome avec SWG bar : installez SWG bar (macOS 14+ puce Apple, essai gratuit de 14 jours d’utilisation) et naviguez ou lancez la commande en erreur. Ouvrez SWG bar → Domaines ou exécutez
swgbar domains list --status confirmedpour lister chaque nom d’hôte dont le certificat TLS a été resigné par la CA de votre locataire Netskope (souvent au formatca.<tenant>.goskope.comou la CA personnalisée de votre entreprise). Associez-le à l’extension Chrome SWG bar gratuite pour afficher des badges d’état dans la barre d’outils du navigateur. - Vérifier les certificats Netskope et l’émetteur en direct dans Terminal :
# Check whether a Netskope CA is installed in the macOS System Keychain
security find-certificate -c "Netskope" /Library/Keychains/System.keychain
# Inspect the live certificate issuer returned for a specific hostname
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
N’oubliez pas que les politiques Netskope déchiffrent souvent certains domaines SaaS ou d’hébergement de code tout en laissant d’autres intacts ; testez toujours le nom d’hôte exact qui échoue.
2. Pourquoi quitter Netskope Client ne fonctionne généralement pas
Dans les environnements gérés où la politique anti-altération Netskope (Protect Client configuration and resources) est activée, l’option Disable dans l’icône de barre des menus Netskope est grisée ou protégée par mot de passe, et forcer le déchargement du daemon casse le routage réseau du système. Effacer les champs proxy Wi-Fi de macOS n’a aucun effet non plus, car Netskope dirige le trafic au niveau de la couche macOS NetworkExtension.
3. Choisir la bonne solution Netskope sur macOS
| Méthode | Arrête le déchiffrement Netskope ? | Nécessite un administrateur locataire Netskope ? | Idéal lorsque |
|---|---|---|---|
Contournement SWG par domaine (SWG bar) |
Oui, pour les noms d’hôte sélectionnés via IPv4 physique Matériel |
Non (contrôle local sur un Mac autorisé) | Une app épinglée, un WebSocket ou un point de terminaison développeur échoue sous déchiffrement Netskope et un chemin IPv4 direct existe (Comment contourner une SWG sur Mac) |
Exception locataire Netskope Do Not Decrypt / Certificate Pinned Apps |
Oui, de façon centralisée sur les Mac gérés | Oui (Policies → SSL Decryption → Do Not Decrypt ou Steering Configuration → Exceptions) | Des applications bureau épinglées à l’échelle de l’organisation ou des points de terminaison partagés échouent pour toute l’équipe (Contournement de SWG vs exception TLS) |
Bundle CA combiné (nscacert_combined.pem) pour outils CLI |
Non (le trafic reste inspecté) | Non | La politique impose un routage Netskope déchiffré et les outils CLI/IA ont simplement besoin de faire confiance à la chaîne CA Netskope |
4. Appliquer le contournement par domaine ou configurer la confiance CA CLI Netskope
Option A : contournement par domaine via SWG bar (si autorisé)
- Ouvrez SWG bar → Domaines, sélectionnez le nom d’hôte inspecté exact (par exemple
api.anthropic.comoupypi.org), puis cliquez sur Activer le contournement pour ce domaine dans la ligne Contourner la SWG — ou exécutezswgbar bypass enable <domain>. - Attendez l’apparition de Contournement actif, puis redémarrez l’onglet du navigateur, l’outil Terminal ou l’IDE afin que les connexions TLS/HTTP/3 groupées se reconnectent via l’interface physique IPv4
Matériel. - Confirmez avec
swgbar probe <domain>que la chaîne de certificats publique du serveur d’origine est désormais servie. Pour revenir en arrière immédiatement, cliquez sur la commande active ou exécutezswgbar bypass disable <domain>.
Option B : créer un bundle PEM combiné pour les outils CLI sous Netskope
Si le trafic doit rester inspecté par Netskope, exportez un bundle PEM combiné depuis vos magasins de confiance macOS (ou utilisez le fichier nscacert_combined.pem fourni par votre équipe IT) et pointez vos outils de développement dessus dans ~/.zshrc :
security find-certificate -a -p \
/System/Library/Keychains/SystemRootCertificates.keychain \
/Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"
export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
Consultez Corriger les erreurs de certificats TLS et SSL liés à une SWG dans les outils CLI et IA et Confiance CA pour Homebrew, Docker, Python et Node.js pour la configuration spécifique à chaque outil.