Como contornar a inspeção HTTPS e TLS no macOS (guia de break-and-inspect)

Contorne a descriptografia break-and-inspect HTTPS e TLS no macOS por domínio com o SWG bar: como o término de TLS quebra HTTP/2, QUIC e pinning, além de verificação via CLI.

SWG bar · Atualizado

Para contornar a inspeção HTTPS ou TLS (break-and-inspect) para um domínio específico no macOS sem desativar globalmente seu cliente de segurança, abra SWG bar → Domínios, selecione o nome de host e ative Contornar SWG (ou execute swgbar bypass enable <domain>). Aguarde até que a linha exiba Contorno ativo e, em seguida, reinicie a aba do navegador, a IDE ou a sessão da CLI para estabelecer um novo handshake TLS pela interface física IPv4 Hardware do seu Mac.

Secure Web Gateways (SWGs) corporativos e firewalls de próxima geração inspecionam o tráfego HTTPS atuando como um intermediário (man-in-the-middle) confiável: eles encerram o handshake TLS 1.2/1.3 de saída do seu Mac, inspecionam os payloads HTTP descriptografados e criptografam o tráfego novamente até o servidor de origem. Embora os navegadores aceitem silenciosamente a CA raiz do gateway instalada por MDM, protocolos modernos e clientes de desenvolvimento mais rígidos quebram com frequência sob nova assinatura TLS.

O que o break-and-inspect HTTPS/TLS realmente quebra em um Mac

Mesmo quando o seu Mac confia no certificado raiz corporativo no Acesso às Chaves, o término de TLS em linha interrompe quatro fluxos comuns no macOS:

  1. Fixação de certificado (certificate pinning) e TLS mútuo (mTLS): aplicativos que fixam a chave pública do servidor de origem ou apresentam um certificado de cliente abortam o handshake no instante em que o gateway substitui o certificado folha pelo seu próprio. Veja Fixação de certificado e mTLS sob inspeção SWG.
  2. HTTP/3 (QUIC) e fluxos persistentes HTTP/2 ou WebSocket: gateways que fazem downgrade ou atuam como proxy em conexões TLS frequentemente descartam fluxos UDP QUIC, travam respostas em streaming de LLMs ou reiniciam canais persistentes de IDE/WebSocket.
  3. Repositórios de CA independentes em CLI e linguagens: runtimes como Node.js, Python, Git, Homebrew, Docker, Claude Code e Cursor trazem repositórios embutidos de CAs raiz e falham com CERTIFICATE_VERIFY_FAILED ou UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
  4. APIs de desenvolvimento sensíveis à latência: redirecionar todo handshake TLS até um PoP distante da SWG em nuvem adiciona latência de ida e volta a instalações de pacotes, fetches do git e preenchimento automático de código em tempo real.

Contorno TLS por domínio vs. configurações locais de proxy e exceções no gateway

Aspecto Contorno por domínio (SWG bar) Exceção administrativa de inspeção TLS (Do Not Decrypt) Edições locais de proxy (Ajustes do Sistema → Proxies)
Camada Roteamento físico IPv4 por nome de host via NetworkExtension do macOS Política central de descriptografia da SWG / firewall Apenas campos explícitos de proxy HTTP/HTTPS do sistema operacional
Funciona contra SWGs transparentes? Sim, quando existe um caminho físico IPv4 alcançável Sim (configurada pela TI) Não — ignorada ou sobrescrita por agentes SWG utun / transparentes
Exige console administrativo de TI? Não (controle local em Mac autorizado) Sim (portal administrativo Zscaler, Netskope, Cloudflare, Palo Alto) Não
Preserva postura do dispositivo / SSO? Sim — o agente corporativo de endpoint permanece em execução Sim Frequentemente quebra o roteamento corporativo de PAC

Para uma análise arquitetural detalhada comparando mudanças de rota e exclusões de descriptografia no gateway, leia Bypass de SWG vs. exceção de inspeção TLS.

Contorne a inspeção HTTPS e TLS para um domínio no macOS

  1. Identifique cada nome de host inspecionado: abra SWG bar → Domínios ou execute swgbar domains list --status confirmed pela CLI. Lembre-se de que example.com, auth.example.com e api.example.com são nomes de host separados.
  2. Ative o contorno por domínio: clique em Ativar contorno para este domínio na linha Contornar SWG do domínio, ou execute:
swgbar bypass enable api.example.com
swgbar bypass status
  1. Encerre conexões TLS e HTTP/3 em pool: atualizar uma única aba do navegador pode reutilizar um soquete HTTP/2 ou QUIC em pool da rota inspecionada. O contorno nativo do SWG bar faz o fallback de HTTP/3 para HTTPS sobre TCP em novas conexões; portanto, recarregue a aba ou encerre e reabra o aplicativo de destino depois que Contorno ativo aparecer.
  2. Verifique a nova cadeia de certificados: execute swgbar probe api.example.com (ou openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null) para confirmar que o emissor público do servidor de origem está sendo retornado.

Se aparecer Recuperando… ou Contorno pausado em vez de Contorno ativo, consulte Corrigir Recuperando…, Contorno pausado e erros de SWG no Mac.

Desative o contorno ou recorra à confiança de CA quando necessário

Clique novamente no controle ativo de Contornar SWG — ou execute swgbar bypass disable <domain> — para devolver imediatamente um nome de host ao roteamento padrão pelo gateway. Encerrar o SWG bar também interrompe o contorno ativo na hora, mantendo suas seleções de nomes de host salvas para a próxima inicialização.

Se a sua rede bloquear tráfego IPv4 direto de saída no nível do firewall, desative o contorno e aplique correções de confiança de CA para ferramentas de CLI e IA ou solicite ao administrador uma regra Do Not Decrypt para o nome de host exato.