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:
- 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.
- 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.
- Repositórios de CA independentes em CLI e linguagens: runtimes como
Node.js,Python,Git,Homebrew,Docker,Claude CodeeCursortrazem repositórios embutidos de CAs raiz e falham comCERTIFICATE_VERIFY_FAILEDouUNABLE_TO_GET_ISSUER_CERT_LOCALLY. - 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
- Identifique cada nome de host inspecionado: abra SWG bar → Domínios ou execute
swgbar domains list --status confirmedpela CLI. Lembre-se de queexample.com,auth.example.comeapi.example.comsão nomes de host separados. - 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
- 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.
- Verifique a nova cadeia de certificados: execute
swgbar probe api.example.com(ouopenssl 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.