Source: https://swgbar.com/pt-BR/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: pt-BR

# Por que apps com fixação de certificado e mTLS falham sob inspeção SWG

Entenda por que aplicativos com fixação de certificado TLS (certificate pinning) ou mutual TLS (mTLS) falham atrás da inspeção HTTPS break-and-inspect no macOS mesmo quando o MDM confia na CA raiz.

SWG bar · Atualizado 18 de novembro de 2026

Colaboradores em Macs gerenciados por MDM frequentemente percebem que sites comuns funcionam normalmente atrás de um Secure Web Gateway (SWG) corporativo, enquanto aplicativos desktop específicos, atualizadores de segurança, SDKs móveis ou APIs de desenvolvimento falham imediatamente no handshake TLS. Na maioria dos casos, o motivo é a **fixação de certificado** (_certificate pinning_) ou **mutual TLS (mTLS)** colidindo com a **inspeção HTTPS/SSL (break-and-inspect)** da SWG.

## Por que a confiança raiz via MDM não resolve o certificate pinning

Durante a navegação HTTPS comum, o Safari e o Chrome confiam em qualquer cadeia de certificados válida ancorada em uma autoridade presente no **Acesso às Chaves do macOS (Keychain)** — incluindo CAs raiz corporativas distribuídas pelo MDM.

Aplicativos que implementam **fixação de certificado TLS (HPKP / pinning de SPKI)** vão além: eles incorporam o hash de chave pública esperado (SPKI) ou o certificado folha/intermediário diretamente no binário do aplicativo. Quando uma SWG corporativa termina o TLS e assina o certificado novamente com sua própria CA raiz empresarial:

1.  O Keychain do macOS informa que o certificado da SWG é válido.
2.  O aplicativo com pinning compara a impressão digital da chave pública do certificado da SWG com o pin embutido.
3.  As impressões digitais não coincidem — portanto, o aplicativo aborta imediatamente o handshake TLS para se proteger contra interceptação man-in-the-middle.

## Por que o mutual TLS (mTLS) falha durante break-and-inspect

No **mutual TLS (mTLS)**, ambos os lados se autenticam: o cliente apresenta um certificado de cliente ao servidor de origem antes que o acesso seja liberado (comum em APIs bancárias, endpoints B2B, APIs zero-trust e serviços de desenvolvimento com suporte a hardware).

Se uma SWG ficar no meio e terminar a conexão TLS para descriptografar os payloads HTTP, o servidor de origem enxergará a conexão da SWG em vez do handshake TLS de cliente do seu Mac — quebrando a validação de ponta a ponta do certificado de cliente, a menos que o gateway atue apenas como passagem criptografada (_pass-through_) ou exclua esse host.

## Diagnostique quais nomes de host são interceptados no seu Mac

Antes de solicitar uma regra de gateway à equipe de TI ou configurar uma regra local, identifique exatamente qual nome de host o aplicativo com pinning ou mTLS acessa:

1.  Abra o [SWG bar](<https://swgbar.com/pt-BR/install/>) e reproduza a falha de conexão no aplicativo.
2.  Confira **SWG bar → Domínios** (ou execute `swgbar domains list --status confirmed`) para localizar o nome de host exato de API, CDN ou atualização acessado por esse aplicativo.
3.  Inspecione os detalhes do domínio e a aba **Certificados** para confirmar se a CA raiz da SWG corporativa está terminando o TLS para esse host.

![Aba Certificados do SWG bar exibindo CAs raiz e contagem de domínios associados; prévia ilustrativa.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

_Verifique se o nome de host de API ou atualização de um aplicativo aparece sob um agrupamento de CA de inspeção no SWG bar._

## Escolha a solução adequada

*   **Fluxos corporativos gerenciados e de produção**: solicite ao administrador de TI ou segurança uma **exceção de inspeção TLS direcionada (regra para não descriptografar)** para o nome de host com pinning ou mTLS, preservando o roteamento pelo gateway sem quebrar a fixação de certificado. Veja [Bypass de SWG vs. exceção de inspeção TLS](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>).
*   **Testes locais autorizados e desenvolvimento**: em redes que você administra ou tem autorização para testar, use o [contorno de SWG por domínio](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>) em **Domínios** ou `swgbar bypass enable <domain>` para que esse nome de host específico se conecte sem descriptografia no gateway.
*   **Erros de repositório de CAs em runtimes de CLI e IA**: se a falha não for pinning estrito, mas sim ferramentas como `git`, `npm`, `Python`, `Claude Code` ou `Cursor` ignorando o Keychain do macOS, siga [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/>).

## 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 a inspeção HTTPS e TLS no macOS (guia de break-and-inspect)](<https://swgbar.com/pt-BR/guides/bypass-https-tls-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/>)
*   [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/>)
