Как обойти HTTPS- и TLS-инспекцию в macOS (руководство по break-and-inspect)

Обойдите расшифровку HTTPS и TLS break-and-inspect в macOS по доменам с помощью SWG bar: как разрыв TLS нарушает HTTP/2, QUIC и pinning, плюс проверка через CLI.

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

Чтобы обойти HTTPS- или TLS-инспекцию (break-and-inspect) для отдельного домена в macOS без глобального отключения агента безопасности, откройте SWG bar → Домены, выберите имя хоста и включите Обойти SWG (или выполните swgbar bypass enable <domain>). Дождитесь статуса Обход активен, затем перезапустите вкладку браузера, IDE или сеанс CLI, чтобы новое TLS-рукопожатие прошло через физический IPv4-интерфейс Аппаратный вашего Mac.

Корпоративные защищённые веб-шлюзы (SWG) и межсетевые экраны нового поколения инспектируют HTTPS-трафик, выступая в роли доверенного посредника (man-in-the-middle): они завершают исходящее рукопожатие TLS 1.2/1.3 от вашего Mac, проверяют расшифрованное содержимое HTTP и повторно шифруют трафик к исходному серверу. Хотя браузеры молча принимают установленный через MDM корневой CA шлюза, современные протоколы и строгие клиентские инструменты разработчика часто дают сбой при переподписи TLS.

Что на самом деле ломает HTTPS/TLS break-and-inspect на Mac

Даже когда ваш Mac доверяет корпоративному корневому сертификату в «Связке ключей», промежуточное завершение TLS нарушает четыре частых сценария в macOS:

  1. Привязка сертификатов (certificate pinning) и взаимный TLS (mTLS): приложения, проверяющие закреплённый открытый ключ исходного сервера или предъявляющие клиентский сертификат, прерывают рукопожатие в тот момент, когда шлюз подставляет собственный конечный сертификат. Подробнее см. в статье Привязка сертификатов и mTLS при инспекции SWG.
  2. HTTP/3 (QUIC) и долгоживущие потоки HTTP/2 или WebSocket: шлюзы, понижающие версию протокола или проксирующие TLS-соединения, часто сбрасывают UDP-потоки QUIC, подвешивают потоковые ответы LLM или разрывают постоянные каналы IDE и WebSocket.
  3. Независимые хранилища CA у CLI и языковых сред: среды выполнения вроде Node.js, Python, Git, Homebrew, Docker, Claude Code и Cursor поставляются со встроенными хранилищами корневых CA и завершаются с ошибками CERTIFICATE_VERIFY_FAILED или UNABLE_TO_GET_ISSUER_CERT_LOCALLY.
  4. Чувствительные к задержкам API для разработки: маршрутизация каждого TLS-рукопожатия через удалённый облачный узел SWG (PoP) увеличивает сетевые задержки при установке пакетов, выполнении git fetch и автодополнении кода в реальном времени.

Подоменный обход TLS, локальные настройки прокси и исключения на шлюзе

Критерий Подоменный обход (SWG bar) Исключение TLS-инспекции у администратора (Do Not Decrypt) Локальные правки прокси (Системные настройки → Прокси)
Уровень работы Маршрутизация отдельных имён хостов по физическому IPv4 через macOS NetworkExtension Центральная политика расшифровки SWG или межсетевого экрана Только явные поля HTTP/HTTPS-прокси ОС
Работает с прозрачными SWG? Да, при наличии доступного физического маршрута IPv4 Да (настраивается службой ИТ) Нет — игнорируется или перезаписывается агентами utun / прозрачными SWG
Требуется консоль администратора ИТ? Нет (локальное управление на авторизованном Mac) Да (портал администратора Zscaler, Netskope, Cloudflare, Palo Alto) Нет
Сохраняет device posture и SSO? Да — корпоративный агент продолжает работать Да Часто нарушает корпоративную маршрутизацию PAC

Подробное архитектурное сравнение изменения маршрута и исключений расшифровки на шлюзе см. в статье Обход SWG и исключение TLS-инспекции.

Как обойти HTTPS- и TLS-инспекцию для домена в macOS

  1. Определите все проверяемые имена хостов: откройте SWG bar → Домены или выполните swgbar domains list --status confirmed через CLI. Помните, что example.com, auth.example.com и api.example.com — это отдельные имена хостов.
  2. Включите обход для домена: нажмите Включить обход для этого домена в строке Обойти SWG нужного хоста или выполните:
swgbar bypass enable api.example.com
swgbar bypass status
  1. Закройте повторно используемые соединения TLS и HTTP/3: простое обновление одной вкладки браузера может переиспользовать открытый сокет HTTP/2 или QUIC на прежнем проверяемом маршруте. Встроенный обход SWG bar переводит новые соединения HTTP/3 на HTTPS поверх TCP, поэтому перезагрузите вкладку либо закройте и снова откройте целевое приложение после появления статуса Обход активен.
  2. Проверьте новую цепочку сертификатов: выполните swgbar probe api.example.com (или openssl s_client -connect api.example.com:443 -servername api.example.com -showcerts </dev/null), чтобы убедиться, что возвращается публичный издатель исходного сервера.

Если вместо статуса Обход активен отображается Восстановление… или Обход приостановлен, обратитесь к статье Устранение статусов Восстановление…, Обход приостановлен и ошибок SWG в macOS.

Отключите обход или переключитесь на доверие к CA при необходимости

Нажмите активную кнопку Обойти SWG ещё раз — или выполните swgbar bypass disable <domain> — чтобы мгновенно вернуть имя хоста к стандартной маршрутизации через шлюз. Выход из SWG bar также немедленно останавливает активный обход, сохраняя выбранные имена хостов до следующего запуска.

Если ваша сеть блокирует прямой исходящий IPv4-трафик на уровне межсетевого экрана, отключите обход и воспользуйтесь настройкой доверия к CA для CLI и ИИ-инструментов либо запросите у администратора правило Do Not Decrypt для точного имени хоста.