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

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), 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 (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
  1. 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).
  2. 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.
  • 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.