Como contornar a inspeção SSL no Mac (SWG corporativa e solução por domínio)

Saiba como contornar a inspeção SSL corporativa no macOS por domínio com o SWG bar: por que excluir certificados do Acesso às Chaves ou usar curl -k falha, além de políticas de TI e confiança de CA.

SWG bar · Atualizado

Para contornar a inspeção SSL corporativa para um nome de host específico em um Mac, abra SWG bar → Domínios, selecione o domínio inspecionado e clique em Ativar contorno para este domínio ao lado de Contornar SWG (ou execute swgbar bypass enable <domain> no Terminal). Aguarde Contorno ativo e, em seguida, recarregue a aba do navegador ou reinicie sua ferramenta de desenvolvimento para que as novas conexões TLS sejam roteadas pela interface física IPv4 Hardware do seu Mac, em vez de passarem pela descriptografia SSL do gateway.

Em um Mac corporativo gerenciado via MDM, a inspeção SSL (também chamada de HTTPS break-and-inspect) é aplicada por um Secure Web Gateway (SWG), como Zscaler, Netskope, Cloudflare Gateway, Cisco Secure Client ou Palo Alto GlobalProtect. Diferentemente das configurações comuns de proxy doméstico, a inspeção SSL corporativa depende de uma CA raiz confiável no sistema e de um túnel NetworkExtension do macOS — motivo pelo qual a maioria dos conselhos genéricos da internet quebra o seu Mac ou falha silenciosamente.

Por que soluções genéricas para contornar SSL falham no macOS

Muitos tutoriais genéricos recomendam soluções criadas para depuração local ou engenharia reversa em dispositivos móveis que quebram o acesso corporativo ou expõem suas credenciais:

  • Excluir ou remover a confiança da CA raiz corporativa no Acesso às Chaves: remover uma CA raiz instalada por MDM não impede o gateway de interceptar pacotes. Em vez disso, Safari e Chrome passam a rejeitar imediatamente todos os sites interceptados com NET::ERR_CERT_AUTHORITY_INVALID, e o Jamf, Kandji ou Intune geralmente reinstala o perfil na próxima sincronização.
  • Desativar a verificação TLS (curl -k, NODE_TLS_REJECT_UNAUTHORIZED=0, git http.sslVerify false): desligar a validação de certificados não contorna a inspeção SSL — o tráfego continua passando pelo gateway e sendo descriptografado por ele, ao mesmo tempo em que expõe seus tokens de API e pacotes em qualquer rede Wi-Fi não confiável.
  • Usar Frida ou truques de HSTS no navegador: ferramentas como o Frida fazem hook de SSL pinning durante engenharia reversa mobile/desktop para habilitar a interceptação local, não para contornar uma SWG corporativa acima do dispositivo. Limpar o HSTS em chrome://net-internals/#hsts apenas redefine o estado strict-transport do navegador e deixa intacta a descriptografia no gateway.
  • Desligar os controles de proxy HTTP/HTTPS do Wi-Fi: agentes corporativos de SWG interceptam o tráfego abaixo de Ajustes do Sistema → Rede → Proxies por meio de um proxy transparente NetworkExtension ou de uma interface utun.

Confirme primeiro quais domínios estão passando por inspeção SSL

Antes de adicionar qualquer regra de contorno, confirme se a inspeção SSL está realmente substituindo os certificados do nome de host que falha, em vez de se tratar de um problema de DNS, firewall ou servidor:

  1. Instale o SWG bar (macOS 14+ em Apple silicon, avaliação gratuita de 14 dias de uso) e abra SWG bar → Visão geral (ou execute swgbar overview). Qualquer Taxa de inspeção de domínios acima de 0% confirma que há interceptação ativa por uma CA raiz local no seu Mac.
  2. Abra Domínios (ou execute swgbar probe <domain>) para inspecionar o nome de host exato. Lembre-se de que aplicativos web, logins OAuth, CDNs e registros de pacotes usam nomes de host distintos — veja Contornar SWG em apps web multidomínio, SSO, CDNs e APIs.
  3. Confira a aba Certificados para verificar qual CA raiz MITM corporativa está assinando o certificado folha. Para um passo a passo completo, leia Como saber se o seu Mac está sendo interceptado por uma SWG.

Compare as 3 formas seguras de lidar com a inspeção SSL corporativa no Mac

Opção Interrompe a descriptografia SSL? Melhor cenário Caminho de configuração
Contorno de SWG por domínio (SWG bar) Sim, para os nomes de host selecionados em uma rota IPv4 física Um nome de host inspecionado quebra o pinning, WebSockets ou a latência em uma rede autorizada SWG bar → Domínios → Contornar SWG → Ativar contorno para este domínio ou swgbar bypass enable <domain> (guia completo de contorno)
Exclusão de inspeção SSL no gateway pela TI (Do Not Decrypt) Sim, dentro da política da SWG Aplicativos com certificate pinning em toda a organização, endpoints mTLS ou domínios bancários/de saúde Solicite uma exclusão de política ao administrador; compare em Bypass de SWG vs. exceção de inspeção TLS
Configurar confiança de CA nas ferramentas (NODE_EXTRA_CA_CERTS, SSL_CERT_FILE) Não (o tráfego continua inspecionado) A política exige roteamento descriptografado e ferramentas de CLI apenas rejeitam a CA raiz corporativa Exporte o pacote PEM e configure os runtimes; consulte Confiança de CA no Homebrew, Docker, Python e Node.js

Passo a passo: ative e verifique o contorno SSL por domínio no macOS

  1. Abra SWG bar → Domínios, selecione o nome de host inspecionado e clique em Ativar contorno para este domínio ao lado de Contornar SWG (ou execute swgbar bypass enable <domain> pela CLI ou via MCP).
  2. No primeiro uso, aprove as solicitações da extensão de rede e da configuração de rede do macOS e aguarde até que o domínio exiba Contorno ativo.
  3. Recarregue a aba do navegador ou reinicie o comando com falha no terminal para que soquetes keep-alive existentes e fluxos HTTP/3 abram conexões TCP novas sob a regra de contorno.
  4. Confirme com evidências recentes: execute swgbar probe <domain> (ou faça uma verificação cruzada com OpenSSL e security verify-cert) para verificar se a cadeia de certificados pública do servidor de origem agora é apresentada por uma interface Hardware.

Limites de rede e política: o SWG bar 2.4.12 exige um caminho IPv4 disponível por uma interface de rede física (en0 / en7). Se um firewall corporativo rigoroso descartar conexões diretas de saída, desative a regra (swgbar bypass disable <domain>) para retornar imediatamente ao roteamento normal pelo gateway. Siga sempre as políticas de uso aceitável e segurança da sua organização.