Confiança de CA no Homebrew, Docker, Python e Node.js atrás de SWG no Mac

Por que Homebrew, Docker Desktop, Node.js, Python, git e curl rejeitam certificados TLS assinados pela SWG no macOS — e como configurar pacotes de CA vs. contorno de SWG.

SWG bar · Atualizado

Em um Mac corporativo atrás de inspeção HTTPS break-and-inspect, cada runtime de desenvolvimento valida certificados TLS de maneira diferente. Enquanto o Safari e o Chrome consultam o Keychain do macOS, ferramentas de CLI e contêineres frequentemente utilizam seus próprios pacotes de CA — causando falhas repentinas de build entre gerenciadores de pacotes e SDKs.

Por que diferentes ferramentas de desenvolvimento no Mac falham seletivamente

Ferramenta / Runtime Repositório de confiança padrão no macOS Variável de ambiente ou configuração comum
Node.js / npm / yarn / pnpm Pacote de CAs da Mozilla compilado internamente NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
Python / pip / uv / requests Pacote certifi ou caminho de CA do OpenSSL SSL_CERT_FILE / REQUESTS_CA_BUNDLE
git OpenSSL ou Secure Transport, dependendo do build git config --global http.sslCAInfo /path/to/corp-ca.pem
curl / Homebrew (brew) Secure Transport do macOS ou pacote CA do OpenSSL HOMEBREW_CURLRC / CURL_CA_BUNDLE (confira com curl --version)
Docker Desktop / Contêineres VM Linux e /etc/ssl/certs da imagem (não o Keychain do macOS) Adicione a CA corporativa ao repositório de confiança da VM Docker ou da imagem

1. Identifique qual registro ou nome de host de API está sendo interceptado

Antes de editar perfis de shell ou builds de contêiner, confirme exatamente quais nomes de host externos estão passando por inspeção SSL em vez de falhar por bloqueios de DNS ou firewall:

swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io

Observe que gerenciadores de pacotes frequentemente redirecionam downloads entre múltiplos hosts (por exemplo, formulae.brew.sh → ghcr.io, ou github.com → objects.githubusercontent.com). Veja Contornar SWG em apps web multidomínio, SSO, CDNs e APIs.

2. Escolha entre configurar pacote de CA, exceção TLS ou contorno de SWG

  • Anexe o PEM da CA raiz corporativa: quando a política da empresa exige que todo o tráfego passe por descriptografia na SWG, exporte a CA raiz exata identificada em SWG bar → Certificados e configure NODE_EXTRA_CA_CERTS, SSL_CERT_FILE, REQUESTS_CA_BUNDLE ou http.sslCAInfo de acordo com a orientação de segurança de TI. Nunca desative a verificação TLS (NODE_TLS_REJECT_UNAUTHORIZED=0 ou sslVerify=false).
  • Solicite uma exceção de inspeção TLS à TI: recomendado para registros compartilhados, imagens base do Docker ou ferramentas com fixação rigorosa de certificado, em que manter pacotes de CA personalizados entre CI e máquinas locais é frágil.
  • Use contorno de SWG por domínio em redes autorizadas: quando você administra ou tem autorização para contornar hosts específicos no seu Mac, ative Contornar SWG no SWG bar (ou swgbar bypass enable <domain>) e reinicie o processo da CLI.

Compare os fluxos antes de alterar padrões do sistema

Para resolver erros CERTIFICATE_VERIFY_FAILED passo a passo, leia Corrigir erros de certificado TLS e SSL de SWG em CLI e IA no Mac. Para comparar regras locais de roteamento com exclusões de política no gateway, consulte Bypass de SWG vs. exceção de inspeção TLS.