Source: https://swgbar.com/pt-BR/guides/swg-tls-certificate-errors-macos/
Language: pt-BR

# Corrigir erros de certificado TLS e SSL de SWG em CLI e IA no Mac

Resolva erros CERTIFICATE\_VERIFY\_FAILED e unable to get local issuer certificate no git, npm, Python, Claude Code e Cursor atrás de uma SWG no macOS.

SWG bar · Atualizado 18 de novembro de 2026

Quando um Mac corporativo está atrás de um Secure Web Gateway (SWG) que realiza **inspeção HTTPS/SSL (break-and-inspect)**, o Safari e o Chrome costumam abrir sites sem nenhum alerta, enquanto ferramentas do Terminal e agentes de programação com IA falham com erros de handshake TLS como `SSL: CERTIFICATE_VERIFY_FAILED`, `UNABLE_TO_GET_ISSUER_CERT_LOCALLY` ou `SSL certificate problem: unable to get local issuer certificate`.

Essa diferença ocorre porque os navegadores consultam o **Acesso às Chaves do macOS (Keychain)** — onde o MDM pode instalar a CA raiz de inspeção da sua organização —, ao passo que muitos ambientes de linha de comando (`git`, `curl`, `Node.js`/`npm`, `Python`/`pip`) e ferramentas de IA (`Claude Code`, `Cursor`, servidores MCP) validam certificados usando seus próprios repositórios embutidos de CAs públicas.

## 1\. Confirme qual nome de host está sofrendo inspeção HTTPS

Antes de alterar variáveis de ambiente ou configurações de rede, verifique se a cadeia de certificados do endpoint que está falhando realmente está sendo substituída no seu Mac:

1.  [Instale e abra o SWG bar](<https://swgbar.com/pt-BR/install/>) no macOS 14 ou posterior (Apple silicon).
2.  Execute o comando com falha uma vez e verifique **SWG bar → Domínios** — ou sonde o endpoint exato diretamente pelo Terminal usando a [CLI](<https://swgbar.com/pt-BR/cli/>) incluída no aplicativo:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar probe registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar domains detail registry.npmjs.org
```

3.  Examine a classificação e a CA raiz. Lembre-se de que interfaces web, servidores de autenticação, registros de pacotes e endpoints de API de LLMs frequentemente usam nomes de host distintos — um subdomínio pode passar sem alterações enquanto outro é descriptografado.

Se você utiliza um assistente compatível com MCP, também pode conectar o [servidor MCP integrado do SWG bar](<https://swgbar.com/pt-BR/mcp/>) para que seu cliente de IA consulte diretamente os domínios observados e as cadeias de certificados.

## 2\. Escolha a solução adequada para o seu ambiente

Depois de confirmar que uma CA raiz de inspeção está assinando o certificado do nome de host de destino, escolha uma das três abordagens de acordo com a política da sua rede e a sua autorização:

| Abordagem | Como funciona | Melhor quando |
| --- | --- | --- |
| **Configurar a confiança na CA para a ferramenta** | Aponte o runtime (por exemplo, `NODE_EXTRA_CA_CERTS`, `SSL_CERT_FILE` ou `REQUESTS_CA_BUNDLE`) para um arquivo PEM exportado que inclua a CA raiz corporativa. | A política corporativa exige roteamento inspecionado pela SWG e você confia nessa CA para a ferramenta específica. |
| **Solicitar uma exceção administrativa de inspeção TLS** | A equipe de TI exclui o nome de host da API ou do registro de pacotes da descriptografia HTTPS no gateway, mantendo o roteamento pelo gateway. | Ferramentas com fixação de certificado (_certificate pinning_) ou endpoints de desenvolvimento usados pela equipe quebram sob _break-and-inspect_. |
| **Ativar o contorno de SWG por domínio no SWG bar** | Direciona o nome de host selecionado no macOS sem a descriptografia HTTPS do gateway via barra de menus, CLI ou MCP. | Você administra ou tem autorização para testar uma rota sem inspeção para domínios específicos no seu Mac. |

Leia [Bypass de SWG vs. exceção de inspeção TLS](<https://swgbar.com/pt-BR/guides/swg-bypass-vs-tls-exception/>) para uma comparação arquitetural detalhada entre exceções no gateway e mudanças de rota.

## 3\. Contorne um domínio inspecionado no macOS quando autorizado

Se o contorno por domínio for adequado para a sua rede, você pode ativá-lo para o nome de host exato da API ou do registro pela barra de menus (**SWG bar → Domínios → Contornar SWG → Ativar contorno para este domínio**) ou pelo Terminal:

```
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass enable registry.npmjs.org
/Applications/SWGBar.app/Contents/MacOS/swgbar bypass status
```

Depois que o status indicar **Contorno ativo**, reinicie o comando da CLI, o daemon em segundo plano ou o host de extensões da IDE para encerrar as conexões existentes e reconectar usando a nova regra. Consulte [Como contornar uma SWG no Mac](<https://swgbar.com/pt-BR/guides/how-to-bypass-swg/>) para ver a aprovação inicial da extensão de rede no macOS, o comportamento ao reiniciar e como desativar o contorno ao terminar.

## Considere os limites da plataforma e da rede

*   **Escopo por nome de host**: Contornar `example.com` não inclui automaticamente `api.example.com` nem `auth.example.com`. Verifique cada nome de host acessado pela ferramenta.
*   **Requisitos de rede**: O SWG bar 2.4.12 requer macOS 14+ em Apple silicon e um caminho IPv4 disponível por uma interface de rede física. Se um firewall bloquear conexões diretas de saída ou se a ferramenta impuser seu próprio proxy explícito, desative a regra de contorno e utilize uma exceção TLS do administrador ou a configuração de pacote de CAs.
*   **Verifique com evidências recentes**: Execute uma nova verificação usando o [guia de inspeção HTTPS e SSL](<https://swgbar.com/pt-BR/guides/detect-https-inspection/>) após qualquer alteração, em vez de depender de resultados em cache.

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