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

# Como contornar proxy corporativo e inspeção SSL de SWG no Mac

Por que desligar Proxies nos Ajustes do Sistema do macOS ou executar networksetup falha contra proxies SWG transparentes, e como contornar por domínio ou corrigir erros de certificado na CLI.

SWG bar · Atualizado 19 de novembro de 2026

Se desligar os controles de proxy do Wi-Fi em **Ajustes do Sistema → Rede → Proxies** — ou adicionar domínios via `networksetup -setproxybypassdomains` — ainda deixa o seu Mac atrás da **inspeção SSL do proxy corporativo**, o dispositivo está usando um agente **Secure Web Gateway (SWG)** transparente (`NetworkExtension` ou túnel `utun`), e não um proxy HTTP explícito simples. Para contornar a inspeção da SWG em um nome de host específico 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 tutoriais de proxy no macOS mistura duas arquiteturas corporativas completamente diferentes: **proxies explícitos / arquivos PAC** legados e **agentes SWG transparentes** modernos (como Cisco Umbrella / Cisco Secure Client, Broadcom Cloud SWG, Zscaler, Netskope ou Cloudflare Gateway). Saber qual delas o seu Mac utiliza explica imediatamente por que os ajustes comuns de proxy não fazem efeito — e qual solução realmente funciona.

## 1\. Verifique se o seu Mac usa proxy explícito ou uma SWG transparente

Execute duas checagens rápidas para ver como o tráfego está sendo direcionado no macOS:

1.  **Inspecione as configurações explícitas de proxy do sistema**:

```
scutil --proxy
```

Procure por `HTTPEnable : 1`, `HTTPSEnable : 1` ou `ProxyAutoConfigURLString` (uma URL `.pac`). 2. **Inspecione a interceptação real de certificados HTTPS**: abra **SWG bar → Visão geral** (ou execute `swgbar overview` / `swgbar domains list --status confirmed`).

*   Se `scutil --proxy` vier **vazio**, mas o SWG bar indicar uma **Taxa de inspeção de domínios > `0%`** (com domínios **Confirmado** ou **Suspeito** e **Certificados man-in-the-middle**), o seu Mac está atrás de um **agente SWG transparente** (`NetworkExtension` / `utun`) que captura pacotes abaixo das configurações de proxy do sistema do macOS.
*   Se `scutil --proxy` listar um proxy/PAC corporativo **e** o SWG bar exibir uma CA raiz MITM corporativa, o tráfego está passando por um proxy interceptador explícito/PAC.

## 2\. Proxy explícito vs. proxy SWG transparente no macOS

| Arquitetura | Onde o macOS intercepta o tráfego | `Ajustes do Sistema → Proxies` / `networksetup` contorna? | O que funciona em um Mac autorizado |
| --- | --- | --- | --- |
| **Proxy HTTP/HTTPS explícito ou PAC (não gerenciado)** | Campos de proxy da Configuração do Sistema do macOS | Sim, se não estiver bloqueado via MDM (`Ignorar ajustes de proxy para estes hosts e domínios`) | Lista de exclusão de proxy do macOS ou verificação de roteamento por domínio |
| **Proxy explícito bloqueado por MDM ou SWG transparente (`NetworkExtension` / `utun`)** | Filtro de soquetes e IP no kernel / NetworkExtension abaixo dos controles de proxy do navegador | **Não** — as configurações ficam bloqueadas, são sobrescritas ou totalmente ignoradas pelo túnel SWG | Contorno físico IPv4 `Hardware` por domínio com o **SWG bar** ([Como contornar uma SWG no Mac](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>)), exclusões de gateway da TI **External Domains / Do Not Decrypt** ou configuração de pacote de CAs na CLI |

## 3\. Contorne a inspeção SSL de proxy SWG para um domínio específico no macOS

Quando um aplicativo web específico, endpoint de API ou cliente desktop com _certificate pinning_ falha atrás de um proxy SWG corporativo em uma rede que você administra ou tem autorização para configurar:

1.  [Instale e abra o SWG bar](<https://swgbar.com/pt-BR/install/>) (macOS 14+ em Apple silicon, avaliação gratuita de 14 dias de uso) e reproduza a requisição para que o nome de host exato apareça em **Domínios**.
2.  Abra os detalhes do nome de host e clique em **Ativar contorno para este domínio** na linha **Contornar SWG** — ou execute:

```
swgbar bypass enable <domain>
swgbar bypass status
```

3.  Aguarde **Contorno ativo** e recarregue a página web ou reinicie o terminal/cliente desktop para que os soquetes _keep-alive_ existentes reabram pela interface física IPv4 `Hardware` do seu Mac (`en0` / `en7`).
4.  Verifique com `swgbar probe <domain>` se a cadeia de certificados pública do servidor de origem é apresentada corretamente. Observe que, se um aplicativo definir sua própria configuração explícita de proxy (por exemplo `HTTP_PROXY` / `HTTPS_PROXY` em `~/.zshrc`, `~/.npmrc` ou `~/.gitconfig`), remova essas variáveis de proxy para esse host para que o aplicativo não force o tráfego de volta à porta do proxy explícito.

## 4\. Quando não é possível contornar o proxy: exclusões de TI e pacotes de CAs na CLI

Se o firewall corporativo bloquear todo tráfego IPv4 direto de saída que não passe pelo proxy SWG (um perímetro _fail-closed_):

*   **Desative o contorno por domínio** (`swgbar bypass disable <domain>`) para que o nome de host retorne imediatamente ao roteamento normal do proxy.
*   **Configure ferramentas de CLI para confiar na CA do proxy corporativo**: aponte `git`, `curl`, `npm`, `Python`, `Homebrew`, `Claude Code` e `Cursor` para o arquivo PEM exportado da CA corporativa (`SSL_CERT_FILE`, `NODE_EXTRA_CA_CERTS`, `REQUESTS_CA_BUNDLE`, `git http.sslCAInfo`), em vez de desativar a verificação SSL de forma insegura. Veja [Corrigir erros de certificado TLS e SSL de SWG em ferramentas de CLI e IA](<https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/>).
*   **Solicite à TI um contorno no gateway ou exceção de descriptografia**: informe à TI os nomes de host exatos com falha (incluindo domínios de login e CDN) e as evidências de certificados do SWG bar para que possam adicionar uma regra central **Do Not Decrypt** ou **External Domains List**. Compare as duas camadas em [Bypass de SWG vs. exceção de inspeção TLS](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>).

## 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 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 Zscaler no Mac: como verificar e contornar por domínio](<https://swgbar.com/pt-BR/guides/zscaler-ssl-inspection-bypass-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/>)
