Contornar SWG em apps web multidomínio, SSO, CDNs e APIs no Mac

Por que contornar apenas o domínio raiz não basta em apps modernos — descubra nomes de host de login, CDN e API no SWG bar e encerre conexões keep-alive com segurança.

SWG bar · Atualizado

Uma surpresa comum ao ativar Contornar SWG no macOS é ver a página web principal recarregar enquanto redirecionamentos de login, imagens, downloads de pacotes ou chamadas de API continuam passando por inspeção HTTPS ou falham. Como o SWG bar aplica regras de contorno por nome de host exato, aplicativos web multidomínio e ferramentas de desenvolvimento costumam depender de vários hosts separados.

Por que o contorno de um único nome de host não cobre subdomínios

Ativar o contorno em app.example.com roteia apenas app.example.com. Isso não contorna automaticamente:

  • Provedores de Single Sign-On (SSO) e OAuth: login.example.com, auth.example.com, sso.company.com ou hosts de identidade de terceiros (accounts.google.com, login.microsoftonline.com).
  • Endpoints de API e IA: api.example.com, graphql.example.com ou subdomínios separados de telemetria e streaming.
  • Recursos estáticos e registros: cdn.example.net, assets.example.com ou buckets de armazenamento de objetos (*.s3.amazonaws.com, objects.githubusercontent.com).

Observe que nomes de host não identificáveis ou com SNI/ECH criptografado não podem ser correspondidos para contorno por domínio.

Encontre todos os nomes de host inspecionados usados por um aplicativo

  1. Abra o site ou execute uma vez o fluxo de desenvolvimento que está falhando enquanto o SWG bar está monitorando.
  2. Em SWG bar → Domínios, ordene ou filtre por Confirmado / Suspeito e pesquise por palavra-chave (por exemplo, example ou auth), ou consulte pela CLI:
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
  1. Para cada nome de host inspecionado exigido pelo fluxo de trabalho, abra seus detalhes e ative Contornar SWG (ou execute swgbar bypass enable <hostname>).
  2. Lembre-se de que contornar um domínio de autenticação ou API em uma rede autorizada não significa que todos os outros domínios não relacionados devam ser contornados — mantenha as regras restritas estritamente aos hosts específicos que precisam delas.

Encerre conexões keep-alive e confira o status no Chrome

Mesmo depois de aparecer Contorno ativo, navegadores e daemons em segundo plano reutilizam soquetes keep-alive HTTP/2, HTTP/3 ou TLS já existentes na rota inspecionada anterior:

  • Navegadores web: recarregue a aba afetada (Cmd + Shift + R), ou feche e reabra a janela do navegador se o site usar conexões WebSocket ou HTTP/3 persistentes. Use a extensão complementar do Chrome para verificar o nome de host ativo exibido para a aba atual — lembrando que a extensão mostra observações registradas pelo SWG bar, em vez de inspecionar o soquete ao vivo do Chrome.
  • Terminal e IDEs: reinicie processos de longa duração (npm, daemon do Claude Code, servidores de linguagem da IDE ou auxiliares de credenciais do git) para que abram novas conexões TCP/TLS pela interface física.

Verifique cada nome de host separadamente

Após atualizar as regras, abra Domínios (ou execute swgbar domains detail <hostname>) e confira se novas sondagens confirmam confiança pública para cada nome de host do fluxo — não apenas para a URL de nível superior exibida na barra de endereços do navegador. Se um domínio corporativo de SaaS ou SSO afetar toda a equipe, avalie se uma exceção de política configurada pelo administrador é mais adequada em Bypass de SWG vs. exceção de inspeção TLS.