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