Обход SWG для многодоменных веб-приложений, SSO, CDN и API на Mac

Почему обхода одного корневого домена недостаточно для современных приложений — находите хосты входа, CDN и API в SWG bar и корректно сбрасывайте keep-alive соединения.

SWG bar · Обновлено

При включении Обойти SWG в macOS часто возникает неожиданная ситуация: основная страница сайта открывается, но перенаправления входа, изображения, загрузки пакетов или вызовы API по-прежнему проходят HTTPS-инспекцию или завершаются ошибкой. Поскольку SWG bar применяет правила обхода строго для точного имени хоста, многодоменные веб-приложения и инструменты разработки обычно зависят сразу от нескольких отдельных хостов.

Почему обход одного имени хоста не распространяется на поддомены

Включение обхода для app.example.com перенаправляет только app.example.com. Оно не обходит автоматически:

  • Провайдеров Single Sign-On (SSO) и OAuth: login.example.com, auth.example.com, sso.company.com или сторонние хосты идентификации (accounts.google.com, login.microsoftonline.com).
  • Конечные точки API и ИИ: api.example.com, graphql.example.com либо отдельные поддомены телеметрии и потоковой передачи данных.
  • Статические ресурсы и реестры: cdn.example.net, assets.example.com или бакеты объектного хранилища (*.s3.amazonaws.com, objects.githubusercontent.com).

Учтите, что неопознаваемые имена хостов или имена с зашифрованным SNI/ECH не могут быть сопоставлены для подоменного обхода.

Найдите все проверяемые имена хостов, используемые приложением

  1. Откройте веб-сайт или один раз запустите сбойный сценарий разработки, пока SWG bar ведёт мониторинг.
  2. В разделе SWG bar → Домены отсортируйте или отфильтруйте список по статусу Подтверждено / Есть признаки и выполните поиск по ключевому слову (например, example или auth), либо запросите список через CLI:
swgbar domains list --status confirmed --search example
swgbar domains list --bypass active
  1. Для каждого проверяемого имени хоста, необходимого для работы сценария, откройте его сведения и включите Обойти SWG (либо выполните swgbar bypass enable <hostname>).
  2. Помните, что включение обхода для одного домена авторизации или API в разрешённой сети не означает, что нужно обходить все остальные несвязанные домены — оставляйте правила только для тех конкретных хостов, которым это действительно необходимо.

Закройте keep-alive соединения и проверьте статус в Chrome

Даже после появления статуса Обход активен браузеры и фоновые демоны продолжают переиспользовать существующие сокеты HTTP/2, HTTP/3 или TLS keep-alive по прежнему проверяемому маршруту:

  • Веб-браузеры: принудительно перезагрузите нужную вкладку (Cmd + Shift + R) или закройте и заново откройте окно браузера, если сайт удерживает длительные подключения WebSocket или HTTP/3. Используйте сопутствующее расширение Chrome, чтобы увидеть активное имя хоста для текущей вкладки — помня, однако, что расширение показывает сохранённые наблюдения SWG bar, а не считывает живой сокет Chrome.
  • Терминал и IDE: перезапустите длительно работающие процессы (npm, фоновую службу Claude Code, языковые серверы IDE или помощники учётных данных git), чтобы они открыли свежие TCP/TLS-соединения через физический интерфейс.

Проверьте каждое имя хоста по отдельности

После обновления правил откройте Домены (или выполните swgbar domains detail <hostname>) и убедитесь, что свежие проверки подтверждают публичное доверие для каждого имени хоста в цепочке запросов, а не только для основного URL в адресной строке браузера. Если корпоративный домен SaaS или SSO затрагивает всю команду, сравните, не подойдёт ли лучше централизованное исключение политики на шлюзе в статье Обход SWG и исключение TLS-инспекции.