Source: https://swgbar.com/pt-BR/guides/bypass-https-tls-inspection-mac/
Language: pt-BR

# 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 19 de novembro de 2026

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](<https://swgbar.com/pt-BR/guides/certificate-pinning-mtls-swg-inspection-macos/>).
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](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>).

## 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](<https://swgbar.com/pt-BR/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
```

3.  **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.
4.  **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](<https://swgbar.com/pt-BR/guides/troubleshoot-swg-bypass-recovering-paused-macos/>).

## 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](<https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/>) ou solicite ao administrador uma regra **Do Not Decrypt** para o nome de host exato.

## 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 proxy corporativo e inspeção SSL de SWG no Mac](<https://swgbar.com/pt-BR/guides/bypass-corporate-proxy-ssl-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/>)
