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 confirmed para listar cada nome de host cujo certificado TLS foi assinado novamente pela CA do seu tenant Netskope (geralmente no formato ca.<tenant>.goskope.com ou 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)

  1. Abra SWG bar → Domínios, selecione o nome de host inspecionado exato (por exemplo api.anthropic.com ou pypi.org) e clique em Ativar contorno para este domínio ao lado de Contornar SWG — ou execute swgbar bypass enable <domain>.
  2. 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.
  3. 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 execute swgbar 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.