Почему приложения с certificate pinning и mTLS ломаются при инспекции SWG

Узнайте, почему приложения с привязкой сертификатов TLS (certificate pinning) или взаимной TLS-аутентификацией (mTLS) не работают за корпоративным SWG с break-and-inspect в macOS, даже если MDM доверяет корневому CA.

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

Сотрудники с Mac под управлением MDM часто замечают, что обычные сайты без проблем открываются за корпоративным защищённым веб-шлюзом (SWG), тогда как отдельные настольные приложения, модули обновления безопасности, мобильные SDK или API разработчиков сразу же завершаются сбоем рукопожатия TLS. В большинстве случаев причина кроется в конфликте привязки сертификатов (certificate pinning) или взаимного TLS (mTLS) с механизмом HTTPS/SSL break-and-inspect на SWG.

Почему доверие корневому CA из MDM не решает проблему certificate pinning

При обычном просмотре HTTPS-страниц Safari и Chrome доверяют любой действительной цепочке сертификатов, восходящей к центру сертификации в Связке ключей macOS, включая корпоративные корневые CA, установленные через MDM.

Приложения, использующие привязку TLS-сертификатов (HPKP / SPKI pinning), идут дальше: они встраивают ожидаемый хеш открытого ключа (SPKI) либо сам конечный/промежуточный сертификат непосредственно в бинарный файл программы. Когда корпоративный SWG завершает TLS-сеанс и переподписывает сертификат собственным корневым CA компании:

  1. Связка ключей macOS считает сертификат SWG действительным.
  2. Приложение с привязкой сверяет отпечаток открытого ключа сертификата SWG со встроенным эталоном (pin).
  3. Отпечатки не совпадают — поэтому приложение немедленно прерывает TLS-рукопожатие для защиты от атаки посредника (MITM).

Почему взаимный TLS (mTLS) нарушается при break-and-inspect

При взаимной аутентификации TLS (mTLS) проверку проходят обе стороны: клиент предъявляет исходному серверу клиентский сертификат до предоставления доступа (это распространено в банковских API, B2B-шлюзах, API нулевого доверия и сервисах разработчиков с аппаратной привязкой).

Если посередине находится SWG и завершает TLS-соединение для расшифровки полезной нагрузки HTTP, исходный сервер видит соединение самого шлюза SWG, а не клиентское TLS-рукопожатие вашего Mac — что нарушает сквозную проверку клиентского сертификата, если только шлюз не работает в режиме сквозной передачи без расшифровки или не исключает этот хост.

Определите, какие имена хостов перехватываются на вашем Mac

Перед тем как запрашивать правило у ИТ-отдела или настраивать локальное правило, точно выясните, к какому имени хоста обращается приложение с pinning или mTLS:

  1. Откройте SWG bar и воспроизведите сбой подключения в приложении.
  2. Проверьте раздел SWG bar → Домены (или выполните swgbar domains list --status confirmed), чтобы найти точное имя хоста API, CDN или сервера обновлений, с которым связывается приложение.
  3. Откройте сведения о домене и вкладку Сертификаты, чтобы убедиться, что TLS для этого хоста завершается корневым CA корпоративного SWG.
Вкладка Сертификаты в SWG bar с корневыми CA и количеством связанных доменов; иллюстративный пример.

Проверьте, отображается ли имя хоста API или обновлений приложения в кластере проверяющего CA в SWG bar.

Выберите подходящий способ решения

  • Промышленные и управляемые корпоративные сценарии: запросите у ИТ- или ИБ-администратора точечное исключение TLS-инспекции (правило запрета расшифровки) для имени хоста с pinning или mTLS, чтобы сохранить маршрутизацию через шлюз без нарушения привязки сертификата. См. Обход SWG и исключение TLS-инспекции.
  • Авторизованное локальное тестирование и разработка: в сетях, которыми вы управляете или имеете право тестировать, используйте подоменный обход SWG из раздела Домены или команду swgbar bypass enable <domain>, чтобы конкретное имя хоста подключалось без расшифровки на шлюзе.
  • Ошибки хранилища CA в CLI-утилитах и ИИ-инструментах: если проблема связана не со строгим pinning, а с тем, что git, npm, Python, Claude Code или Cursor игнорируют Связку ключей macOS, воспользуйтесь руководством Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ на Mac.