Inspeção SSL do Zscaler no Mac: como verificar e contornar por domínio

Verifique se o Zscaler Client Connector está descriptografando HTTPS no seu Mac, por que encerrar o ZCC falha sob Tamper Protection e como contornar por domínio ou configurar confiança de CA na CLI.

SWG bar · Atualizado

Para verificar se o Zscaler (ZIA / Zscaler Client Connector) está descriptografando tráfego HTTPS 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 uma Zscaler Root CA ou CA intermediária corporativa listada em Certificados man-in-the-middle. Para contornar a inspeção SSL do Zscaler para um único nome de host com falha em um Mac autorizado, abra SWG bar → Domínios, selecione o nome de host e ative Contornar SWG (ou execute swgbar bypass enable <domain>).

A maioria dos guias on-line para contornar o Zscaler parte do princípio de que você tem acesso ao Zscaler Admin Portal (ZIA). Em um MacBook corporativo gerenciado via Jamf, Kandji ou Intune, desenvolvedores e funcionários raramente têm acesso ao portal — mas o Z-Tunnel 2.0 (NetworkExtension / túnel utun) e a Zscaler Root CA quebram rotineiramente aplicativos com certificate pinning, Homebrew, npm, git, Python, Docker, Claude Code e Cursor.

1. Verifique se o Zscaler está inspecionando HTTPS ativamente no seu Mac

Como o MDM pré-instala e confia na Zscaler Root CA no Acesso às Chaves do macOS, Safari e Chrome mostram um cadeado normal mesmo enquanto o Zscaler realiza HTTPS break-and-inspect. Verifique a descriptografia por domínio usando um destes dois métodos:

  • Verificação contínua com o SWG bar: instale o SWG bar (macOS 14+ em Apple silicon, avaliação gratuita de 14 dias de uso) e acesse os sites de destino. Abra SWG bar → Domínios ou Certificados — ou execute swgbar probe <domain> — para ver se o domínio está marcado como Confirmado sob interceptação pela Zscaler Root CA (ou pela CA intermediária Zscaler da sua empresa) ou se passa por Caminho público.
  • Checagem pontual de um domínio no Terminal:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Se issuer= exibir Zscaler ou a CA intermediária Zscaler personalizada da sua organização em vez de uma CA pública (como DigiCert, Let’s Encrypt ou Google Trust Services), a inspeção SSL do Zscaler está ativa para aquele nome de host. Consulte Verificar certificados TLS com OpenSSL e security verify-cert para conferir as impressões digitais SHA-256.

2. Por que encerrar sessão ou descarregar o Zscaler Client Connector falha

Tentar desativar o Zscaler globalmente em um Mac gerenciado quase sempre gera problemas:

  • Tamper Protection: a maioria dos perfis corporativos do ZCC exige uma senha de uso único da TI para sair ou desativar o Internet Security (ZIA), e sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* é bloqueado ou reiniciado imediatamente.
  • Z-Tunnel 2.0 ignora as configurações de proxy do sistema: desligar os controles de proxy HTTP/HTTPS do Wi-Fi nos Ajustes do Sistema do macOS não tem nenhum efeito sobre o direcionamento de pacotes do Z-Tunnel 2.0.
  • Acesso corporativo interrompido: mesmo que o ZCC pare, aplicativos internos via ZPA (Zscaler Private Access) e o SSO condicionado à postura do dispositivo (Okta, Entra ID) param de funcionar.

3. Três formas práticas de lidar com a inspeção SSL do Zscaler no macOS

Abordagem Quem controla Mantém o ZCC e o SSO corporativo ativos? Melhor caso de uso
Contorno de SWG por domínio (SWG bar) Usuário local do Mac (em redes autorizadas) Sim — roteia apenas o nome de host selecionado pela interface física IPv4 Hardware do Mac Alívio imediato por nome de host para apps com pinning, WebSockets ou APIs de desenvolvimento com falha sem desativar o ZCC (Como contornar uma SWG no Mac)
Exclusão no Zscaler Admin Portal (Do Not Inspect / App Profile) Equipe corporativa de TI / Segurança Sim Isenção permanente para toda a organização em Policy → SSL Inspection → Do Not Inspect ou App Profiles → Hostname/IP Bypass no macOS (Bypass de SWG vs. exceção TLS)
Exportar e confiar na Zscaler Root CA nas ferramentas CLI Desenvolvedor local Sim (o tráfego continua inspecionado) A política corporativa exige roteamento descriptografado e git, npm, brew, Python, Claude Code ou Cursor falham com unable to get local issuer certificate

4. Ative o contorno por domínio ou configure a Zscaler Root CA para ferramentas CLI

Opção A: Contorno por domínio com o SWG bar (quando autorizado)

  1. Abra SWG bar → Domínios, encontre o nome de host exato com falha (observe que domínios de login, API e CDN são nomes de host separados — veja contorno multidomínio de SSO, API e CDN) e clique em Ativar contorno para este domínio ao lado de Contornar SWG — ou execute swgbar bypass enable <domain>.
  2. Aguarde Contorno ativo e depois reinicie a aba do navegador, a IDE ou a sessão de CLI para que conexões em pool sejam reabertas pela rota direta IPv4 Hardware.
  3. Verifique com swgbar probe <domain> que a cadeia de certificados pública do servidor de origem agora é retornada. Se um firewall bloquear conexões diretas de saída, execute swgbar bypass disable <domain> para restaurar imediatamente o roteamento normal do Zscaler.

Opção B: Configure ferramentas CLI e de IA para confiar na Zscaler Root CA

Se a política da sua rede exigir que o tráfego continue sendo descriptografado pelo Zscaler, exporte o pacote PEM da Zscaler Root CA pelo Acesso às Chaves (ou solicite o arquivo PEM à TI) e configure seus runtimes em vez de desligar a verificação SSL:

# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"

Para instruções completas abrangendo Homebrew, Docker Desktop, Python, Node.js, Claude Code e Cursor, leia Configurar confiança de CA para Homebrew, Docker, Python e Node.js e Corrigir erros de certificado do Claude Code e Cursor no macOS.