Source: https://swgbar.com/pt-BR/guides/zscaler-ssl-inspection-bypass-mac/
Language: pt-BR

# 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 19 de novembro de 2026

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](<https://swgbar.com/pt-BR/install/>) (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](<https://swgbar.com/pt-BR/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>) 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](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>)) |
| **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](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>)) |
| **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](<https://swgbar.com/pt-BR/guides/multi-domain-sso-api-cdn-swg-bypass/>)) 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](<https://swgbar.com/pt-BR/guides/homebrew-docker-python-node-ca-trust-swg-macos/>) e [Corrigir erros de certificado do Claude Code e Cursor no macOS](<https://swgbar.com/pt-BR/guides/ai-coding-agents-claude-code-cursor-swg-macos/>).

## Continue lendo

*   [Como contornar uma SWG no Mac (contorno por domínio em 1 clique e CLI)](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>)
*   [Como contornar a inspeção SSL no Mac (SWG corporativa e solução por domínio)](<https://swgbar.com/pt-BR/guides/bypass-ssl-inspection-mac/>)
*   [Como contornar a inspeção HTTPS e TLS no macOS (guia de break-and-inspect)](<https://swgbar.com/pt-BR/guides/bypass-https-tls-inspection-mac/>)
*   [Como contornar proxy corporativo e inspeção SSL de SWG no Mac](<https://swgbar.com/pt-BR/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Como saber se o seu Mac está sendo interceptado por uma SWG (inspeção HTTPS e SSL)](<https://swgbar.com/pt-BR/guides/detect-https-inspection/>)
*   [Como saber se sua empresa ou Mac de trabalho está interceptando HTTPS (inspeção SSL)](<https://swgbar.com/pt-BR/guides/check-if-work-mac-intercepting-https/>)
*   [Verificador de inspeção SSL para Mac: ferramenta na barra de menus para detectar interceptação HTTPS](<https://swgbar.com/pt-BR/guides/ssl-inspection-checker-mac/>)
*   [Inspeção SSL do Netskope no Mac: verificar descriptografia e contornar por domínio](<https://swgbar.com/pt-BR/guides/netskope-ssl-inspection-bypass-mac/>)
*   [Inspeção TLS do Cloudflare WARP e Zero Trust no Mac: detectar e contornar](<https://swgbar.com/pt-BR/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Inspeção HTTPS Confirmado vs. Suspeito no SWG bar](<https://swgbar.com/pt-BR/guides/confirmed-vs-suspected-https-inspection/>)
*   [Inspecionar certificados raiz MITM e emissores no SWG bar](<https://swgbar.com/pt-BR/guides/inspect-mitm-root-certificates-macos/>)
*   [Inspeção HTTPS de SWG corporativa e MDM no Mac](<https://swgbar.com/pt-BR/guides/enterprise-swg-https-inspection-macos/>)
*   [Bypass de SWG vs. exceção de inspeção TLS (break-and-inspect)](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>)
*   [Contornar SWG em apps web multidomínio, SSO, CDNs e APIs no Mac](<https://swgbar.com/pt-BR/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Corrigir Recuperando…, Contorno pausado e erros de SWG no Mac](<https://swgbar.com/pt-BR/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Interfaces virtuais de VPN no macOS vs. inspeção HTTPS SWG](<https://swgbar.com/pt-BR/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Por que apps com fixação de certificado e mTLS falham sob inspeção SWG](<https://swgbar.com/pt-BR/guides/certificate-pinning-mtls-swg-inspection-macos/>)
*   [Corrigir erros de certificado TLS e SSL de SWG em CLI e IA no Mac](<https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/>)
*   [Confiança de CA no Homebrew, Docker, Python e Node.js atrás de SWG no Mac](<https://swgbar.com/pt-BR/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Corrigir 'unable to get local issuer certificate' no Claude Code e Cursor no Mac (SWG e MCP)](<https://swgbar.com/pt-BR/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Verificar certificados TLS com openssl e security verify-cert no Mac](<https://swgbar.com/pt-BR/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Permissões do SWG bar, privacidade local e limites de sondagem TLS](<https://swgbar.com/pt-BR/guides/macos-network-extension-privacy-probe-limits/>)
*   [Como o SWG bar verifica a inspeção HTTPS](<https://swgbar.com/pt-BR/how-it-works/>)
*   [Baixar e instalar o SWG bar para Mac (macOS 14+)](<https://swgbar.com/pt-BR/install/>)
*   [Extensão do Chrome para detectar inspeção SSL e HTTPS (complemento do SWG bar)](<https://swgbar.com/pt-BR/chrome-extension/>)
*   [Guia do SWG bar CLI](<https://swgbar.com/pt-BR/cli/>)
*   [Guia do SWG bar MCP](<https://swgbar.com/pt-BR/mcp/>)
*   [Informações de versões do SWG bar](<https://swgbar.com/pt-BR/releases/>)
*   [Sobre o SWG bar](<https://swgbar.com/pt-BR/about/>)
