Почему приложения с 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 компании:
- Связка ключей macOS считает сертификат SWG действительным.
- Приложение с привязкой сверяет отпечаток открытого ключа сертификата SWG со встроенным эталоном (pin).
- Отпечатки не совпадают — поэтому приложение немедленно прерывает TLS-рукопожатие для защиты от атаки посредника (MITM).
Почему взаимный TLS (mTLS) нарушается при break-and-inspect
При взаимной аутентификации TLS (mTLS) проверку проходят обе стороны: клиент предъявляет исходному серверу клиентский сертификат до предоставления доступа (это распространено в банковских API, B2B-шлюзах, API нулевого доверия и сервисах разработчиков с аппаратной привязкой).
Если посередине находится SWG и завершает TLS-соединение для расшифровки полезной нагрузки HTTP, исходный сервер видит соединение самого шлюза SWG, а не клиентское TLS-рукопожатие вашего Mac — что нарушает сквозную проверку клиентского сертификата, если только шлюз не работает в режиме сквозной передачи без расшифровки или не исключает этот хост.
Определите, какие имена хостов перехватываются на вашем Mac
Перед тем как запрашивать правило у ИТ-отдела или настраивать локальное правило, точно выясните, к какому имени хоста обращается приложение с pinning или mTLS:
- Откройте SWG bar и воспроизведите сбой подключения в приложении.
- Проверьте раздел SWG bar → Домены (или выполните
swgbar domains list --status confirmed), чтобы найти точное имя хоста API, CDN или сервера обновлений, с которым связывается приложение. - Откройте сведения о домене и вкладку Сертификаты, чтобы убедиться, что TLS для этого хоста завершается корневым CA корпоративного SWG.
Проверьте, отображается ли имя хоста 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.