Source: https://swgbar.com/pt-BR/guides/homebrew-docker-python-node-ca-trust-swg-macos/
Language: pt-BR

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

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](<https://swgbar.com/pt-BR/guides/multi-domain-sso-api-cdn-swg-bypass/>).

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

## 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/>)
*   [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/>)
*   [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/>)
