Как обойти 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:
- Привязка сертификатов (certificate pinning) и взаимный TLS (mTLS): приложения, проверяющие закреплённый открытый ключ исходного сервера или предъявляющие клиентский сертификат, прерывают рукопожатие в тот момент, когда шлюз подставляет собственный конечный сертификат. Подробнее см. в статье Привязка сертификатов и mTLS при инспекции SWG.
- HTTP/3 (QUIC) и долгоживущие потоки HTTP/2 или WebSocket: шлюзы, понижающие версию протокола или проксирующие TLS-соединения, часто сбрасывают UDP-потоки QUIC, подвешивают потоковые ответы LLM или разрывают постоянные каналы IDE и WebSocket.
- Независимые хранилища CA у CLI и языковых сред: среды выполнения вроде
Node.js,Python,Git,Homebrew,Docker,Claude CodeиCursorпоставляются со встроенными хранилищами корневых CA и завершаются с ошибкамиCERTIFICATE_VERIFY_FAILEDилиUNABLE_TO_GET_ISSUER_CERT_LOCALLY. - Чувствительные к задержкам 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
- Определите все проверяемые имена хостов: откройте SWG bar → Домены или выполните
swgbar domains list --status confirmedчерез CLI. Помните, чтоexample.com,auth.example.comиapi.example.com— это отдельные имена хостов. - Включите обход для домена: нажмите Включить обход для этого домена в строке Обойти SWG нужного хоста или выполните:
swgbar bypass enable api.example.com
swgbar bypass status
- Закройте повторно используемые соединения TLS и HTTP/3: простое обновление одной вкладки браузера может переиспользовать открытый сокет HTTP/2 или QUIC на прежнем проверяемом маршруте. Встроенный обход SWG bar переводит новые соединения HTTP/3 на HTTPS поверх TCP, поэтому перезагрузите вкладку либо закройте и снова откройте целевое приложение после появления статуса Обход активен.
- Проверьте новую цепочку сертификатов: выполните
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 для точного имени хоста.