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
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:
- O Keychain do macOS informa que o certificado da SWG é válido.
- O aplicativo com pinning compara a impressão digital da chave pública do certificado da SWG com o pin embutido.
- 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:
- Abra o SWG bar e reproduza a falha de conexão no aplicativo.
- 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. - 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.
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.
- Testes locais autorizados e desenvolvimento: em redes que você administra ou tem autorização para testar, use o contorno de SWG por domínio 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 CodeouCursorignorando o Keychain do macOS, siga Corrigir erros de certificado TLS e SSL de SWG em CLI e IA no Mac.