Inspeção SSL do Netskope no Mac: verificar descriptografia e contornar por domínio
Verifique se o Netskope Client está descriptografando HTTPS no seu Mac (CA *.goskope.com), compare o contorno por domínio do SWG bar com a política Do Not Decrypt e configure nscacert_combined.pem.
SWG bar · Atualizado
Para verificar se o Netskope Client está realizando descriptografia SSL/TLS no seu Mac, abra SWG bar → Visão geral (ou execute swgbar overview) e confira se a Taxa de inspeção de domínios está acima de 0% com um certificado da Netskope ou do tenant *.goskope.com em Certificados man-in-the-middle. Para contornar a inspeção SSL do Netskope para um nome de host específico em um Mac autorizado, abra SWG bar → Domínios, selecione o nome de host e clique em Ativar contorno para este domínio ao lado de Contornar SWG (ou execute swgbar bypass enable <domain>).
O Netskope Secure Web Gateway é amplamente implantado em frotas corporativas de macOS usando um cliente de direcionamento NetworkExtension e uma CA intermediária específica por tenant. Como a CA raiz da Netskope é instalada via MDM no Acesso às Chaves do macOS, os navegadores exibem indicadores normais de segurança válidos enquanto runtimes de CLI (pip, npm, AWS CLI, git, Docker, Claude Code) e aplicativos desktop com certificate pinning falham com CERTIFICATE_VERIFY_FAILED ou UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
1. Verifique se o Netskope está descriptografando um domínio no seu Mac
Verifique tanto a interceptação em todo o sistema quanto nomes de host individuais:
- Visibilidade na barra de menus e no Chrome com o SWG bar: instale o SWG bar (macOS 14+ em Apple silicon, avaliação gratuita de 14 dias de uso) e navegue ou execute o comando que falha. Abra SWG bar → Domínios ou execute
swgbar domains list --status confirmedpara listar cada nome de host cujo certificado TLS foi assinado novamente pela CA do seu tenant Netskope (geralmente no formatoca.<tenant>.goskope.comou a CA personalizada da empresa). Combine-o com a extensão gratuita do SWG bar para Chrome para ver selos de status na barra de ferramentas do navegador. - Verifique certificados do Netskope e o emissor ao vivo no Terminal:
# Verifica se existe uma CA do Netskope instalada no Chaveiro do Sistema do macOS
security find-certificate -c "Netskope" /Library/Keychains/System.keychain
# Inspeciona o emissor do certificado ao vivo retornado para um nome de host específico
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject
Lembre-se de que políticas do Netskope frequentemente descriptografam alguns domínios SaaS ou de hospedagem de código enquanto direcionam outros intactos; sempre teste o nome de host exato que está falhando.
2. Por que encerrar o Netskope Client geralmente não funciona
Em ambientes gerenciados com a política de proteção contra adulteração Protect Client configuration and resources do Netskope habilitada, a opção Disable no ícone do Netskope na barra de menus fica desabilitada ou protegida por senha, e forçar o descarregamento do daemon quebra o roteamento de rede do sistema. Limpar os campos de proxy do Wi-Fi no macOS também não surte efeito porque o Netskope direciona o tráfego na camada NetworkExtension do macOS.
3. Escolha a correção certa para o Netskope no macOS
| Método | Interrompe a descriptografia do Netskope? | Exige administrador do tenant Netskope? | Melhor quando |
|---|---|---|---|
Contorno de SWG por domínio (SWG bar) |
Sim, para nomes de host selecionados via IPv4 físico Hardware |
Não (controle local em Mac autorizado) | Um app com pinning, WebSocket ou endpoint de desenvolvimento falha sob descriptografia do Netskope e existe um caminho IPv4 direto (Como contornar uma SWG no Mac) |
Exceção Do Not Decrypt / Certificate Pinned Apps no tenant Netskope |
Sim, centralmente nos Macs gerenciados | Sim (Policies → SSL Decryption → Do Not Decrypt ou Steering Configuration → Exceptions) | Aplicativos desktop com pinning ou endpoints de desenvolvimento compartilhados falham para toda a equipe (Bypass de SWG vs. exceção TLS) |
Pacote combinado de CAs (nscacert_combined.pem) para ferramentas CLI |
Não (o tráfego continua inspecionado) | Não | A política exige roteamento descriptografado pelo Netskope e ferramentas CLI/IA apenas precisam confiar na cadeia de CA do Netskope |
4. Aplique o contorno por domínio ou configure a confiança de CA do Netskope para CLI
Opção A: Contorno por domínio via SWG bar (quando autorizado)
- Abra SWG bar → Domínios, selecione o nome de host inspecionado exato (por exemplo
api.anthropic.comoupypi.org) e clique em Ativar contorno para este domínio ao lado de Contornar SWG — ou executeswgbar bypass enable <domain>. - Aguarde até aparecer Contorno ativo e depois reinicie a aba do navegador, a ferramenta de terminal ou a IDE para que conexões TLS/HTTP/3 em pool reconectem pela interface física IPv4
Hardware. - Confirme com
swgbar probe <domain>que a cadeia de certificados pública do servidor de origem agora é entregue. Para reverter imediatamente, clique no controle ativo ou executeswgbar bypass disable <domain>.
Opção B: Crie um pacote PEM combinado para ferramentas CLI sob Netskope
Se o tráfego precisar continuar sendo inspecionado pelo Netskope, exporte um pacote PEM combinado a partir dos repositórios de confiança do macOS (ou use o pacote nscacert_combined.pem fornecido pela sua equipe de TI) e aponte suas ferramentas de desenvolvimento para ele em ~/.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"
Consulte Corrigir erros de certificado TLS e SSL de SWG em ferramentas de CLI e IA e Confiança de CA no Homebrew, Docker, Python e Node.js para a configuração específica de cada ferramenta.