Source: https://swgbar.com/ru/guides/certificate-pinning-mtls-swg-inspection-macos/
Language: ru

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

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

SWG bar · Обновлено 18 ноября 2026 г.

Сотрудники с 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](<https://swgbar.com/ru/install/>) и воспроизведите сбой подключения в приложении.
2.  Проверьте раздел **SWG bar → Домены** (или выполните `swgbar domains list --status confirmed`), чтобы найти точное имя хоста API, CDN или сервера обновлений, с которым связывается приложение.
3.  Откройте сведения о домене и вкладку **Сертификаты**, чтобы убедиться, что TLS для этого хоста завершается корневым CA корпоративного SWG.

![Вкладка Сертификаты в SWG bar с корневыми CA и количеством связанных доменов; иллюстративный пример.](<https://swgbar.com/optimized/panel-native-certificates-four-tabs-720.webp>)

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

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

*   **Промышленные и управляемые корпоративные сценарии**: запросите у ИТ- или ИБ-администратора точечное **исключение TLS-инспекции (правило запрета расшифровки)** для имени хоста с pinning или mTLS, чтобы сохранить маршрутизацию через шлюз без нарушения привязки сертификата. См. [Обход SWG и исключение TLS-инспекции](<https://swgbar.com/ru/guides/swg-bypass-vs-tls-exception/>).
*   **Авторизованное локальное тестирование и разработка**: в сетях, которыми вы управляете или имеете право тестировать, используйте [подоменный обход SWG](<https://swgbar.com/ru/guides/how-to-bypass-swg/>) из раздела **Домены** или команду `swgbar bypass enable <domain>`, чтобы конкретное имя хоста подключалось без расшифровки на шлюзе.
*   **Ошибки хранилища CA в CLI-утилитах и ИИ-инструментах**: если проблема связана не со строгим pinning, а с тем, что `git`, `npm`, `Python`, `Claude Code` или `Cursor` игнорируют Связку ключей macOS, воспользуйтесь руководством [Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ на Mac](<https://swgbar.com/ru/guides/swg-tls-certificate-errors-macos/>).

## Читайте также

*   [Как обойти SWG на Mac (обход по доменам в 1 клик и CLI)](<https://swgbar.com/ru/guides/how-to-bypass-swg/>)
*   [Как обойти SSL-инспекцию на Mac (корпоративный SWG и обход по доменам)](<https://swgbar.com/ru/guides/bypass-ssl-inspection-mac/>)
*   [Как обойти HTTPS- и TLS-инспекцию в macOS (руководство по break-and-inspect)](<https://swgbar.com/ru/guides/bypass-https-tls-inspection-mac/>)
*   [Как обойти корпоративный прокси и SSL-инспекцию SWG на Mac](<https://swgbar.com/ru/guides/bypass-corporate-proxy-ssl-inspection-mac/>)
*   [Как узнать, перехватывает ли SWG ваш Mac (проверка HTTPS и SSL)](<https://swgbar.com/ru/guides/detect-https-inspection/>)
*   [Как проверить, перехватывает ли работодатель или рабочий Mac ваш HTTPS-трафик (SSL-инспекция)](<https://swgbar.com/ru/guides/check-if-work-mac-intercepting-https/>)
*   [Проверка SSL-инспекции на Mac: утилита в строке меню для обнаружения перехвата HTTPS](<https://swgbar.com/ru/guides/ssl-inspection-checker-mac/>)
*   [SSL-инспекция Zscaler на Mac: как проверить и обойти по доменам](<https://swgbar.com/ru/guides/zscaler-ssl-inspection-bypass-mac/>)
*   [SSL-инспекция Netskope на Mac: проверка расшифровки и обход по доменам](<https://swgbar.com/ru/guides/netskope-ssl-inspection-bypass-mac/>)
*   [TLS-инспекция Cloudflare WARP и Zero Trust на Mac: проверка и обход](<https://swgbar.com/ru/guides/cloudflare-warp-tls-inspection-mac/>)
*   [Статусы Подтверждено и Есть признаки при HTTPS-инспекции в SWG bar](<https://swgbar.com/ru/guides/confirmed-vs-suspected-https-inspection/>)
*   [Проверка корневых MITM-сертификатов и издателей в SWG bar](<https://swgbar.com/ru/guides/inspect-mitm-root-certificates-macos/>)
*   [Корпоративный SWG и MDM: проверка HTTPS на Mac](<https://swgbar.com/ru/guides/enterprise-swg-https-inspection-macos/>)
*   [Обход SWG и исключение TLS-инспекции (break-and-inspect)](<https://swgbar.com/ru/guides/swg-bypass-vs-tls-exception/>)
*   [Обход SWG для многодоменных веб-приложений, SSO, CDN и API на Mac](<https://swgbar.com/ru/guides/multi-domain-sso-api-cdn-swg-bypass/>)
*   [Устранение статусов Восстановление…, Обход приостановлен и ошибок SWG на Mac](<https://swgbar.com/ru/guides/troubleshoot-swg-bypass-recovering-paused-macos/>)
*   [Виртуальные интерфейсы VPN в macOS и HTTPS-инспекция SWG](<https://swgbar.com/ru/guides/macos-vpn-virtual-interface-vs-swg-inspection/>)
*   [Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ на Mac](<https://swgbar.com/ru/guides/swg-tls-certificate-errors-macos/>)
*   [Доверие к CA в Homebrew, Docker, Python и Node.js за SWG на Mac](<https://swgbar.com/ru/guides/homebrew-docker-python-node-ca-trust-swg-macos/>)
*   [Исправление ошибки 'unable to get local issuer certificate' в Claude Code и Cursor на Mac (SWG и MCP)](<https://swgbar.com/ru/guides/ai-coding-agents-claude-code-cursor-swg-macos/>)
*   [Проверка TLS-сертификатов через openssl и security verify-cert на Mac](<https://swgbar.com/ru/guides/verify-tls-certificates-openssl-security-verify-cert-macos/>)
*   [Разрешения SWG bar, локальная приватность и лимиты TLS-проверок](<https://swgbar.com/ru/guides/macos-network-extension-privacy-probe-limits/>)
*   [Как SWG bar проверяет HTTPS-соединения](<https://swgbar.com/ru/how-it-works/>)
*   [Скачать и установить SWG bar для Mac (macOS 14+)](<https://swgbar.com/ru/install/>)
*   [Расширение Chrome для обнаружения SSL- и HTTPS-инспекции (компаньон SWG bar)](<https://swgbar.com/ru/chrome-extension/>)
*   [Руководство по SWG bar CLI](<https://swgbar.com/ru/cli/>)
*   [Руководство по SWG bar MCP](<https://swgbar.com/ru/mcp/>)
*   [Информация о выпусках SWG bar](<https://swgbar.com/ru/releases/>)
*   [О SWG bar](<https://swgbar.com/ru/about/>)
