SSL-инспекция Zscaler на Mac: как проверить и обойти по доменам

Проверьте, расшифровывает ли Zscaler Client Connector HTTPS на вашем Mac, почему завершение ZCC не работает при Tamper Protection, и как обойти домен или настроить CA в CLI.

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

Чтобы проверить, расшифровывает ли Zscaler (ZIA / Zscaler Client Connector) HTTPS-трафик на вашем Mac, откройте SWG bar → Обзор (или выполните swgbar overview) и посмотрите, превышает ли Доля проверяемых доменов значение 0% при наличии Zscaler Root CA или корпоративного промежуточного CA в списке Сертификаты перехвата (MITM). Чтобы обойти SSL-инспекцию Zscaler для одного проблемного имени хоста на авторизованном Mac, откройте SWG bar → Домены, выберите хост и включите Обойти SWG (или выполните swgbar bypass enable <domain>).

Большинство онлайн-инструкций по обходу Zscaler предполагают, что у вас есть доступ к Zscaler Admin Portal (ZIA). На корпоративном MacBook под управлением Jamf, Kandji или Intune у разработчиков и сотрудников редко есть доступ к порталу администратора — при этом Z-Tunnel 2.0 (туннель NetworkExtension / utun) и Zscaler Root CA регулярно ломают приложения с привязкой сертификатов, Homebrew, npm, git, Python, Docker, Claude Code и Cursor.

1. Проверьте, инспектирует ли Zscaler HTTPS на вашем Mac

Поскольку MDM заранее устанавливает и добавляет в доверенные Zscaler Root CA в «Связке ключей» macOS, Safari и Chrome показывают обычный замок даже во время HTTPS break-and-inspect со стороны Zscaler. Проверьте расшифровку по доменам одним из двух способов:

  • Непрерывная проверка через SWG bar: установите SWG bar (macOS 14+ Apple silicon, бесплатная пробная версия на 14 дней использования) и откройте нужные сайты. Перейдите в SWG bar → Домены или Сертификаты — либо выполните swgbar probe <domain> — чтобы увидеть, подтверждён ли перехват домена (Подтверждено) сертификатом Zscaler Root CA (или корпоративным промежуточным CA Zscaler) либо он проходит через Публичный путь.
  • Точечная проверка одного домена в Терминале:
openssl s_client -connect api.github.com:443 -servername api.github.com </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Если в строке issuer= указан Zscaler или корпоративный промежуточный CA Zscaler вашей организации вместо публичного CA (такого как DigiCert, Let’s Encrypt или Google Trust Services), для этого имени хоста активна SSL-инспекция Zscaler. Чтобы сверить отпечатки SHA-256, см. Проверка TLS-сертификатов через OpenSSL и security verify-cert.

2. Почему выход из Zscaler Client Connector или его выгрузка не работают

Попытка глобально отключить Zscaler на управляемом Mac почти всегда приводит к проблемам:

  • Защита от вмешательства (Tamper Protection): большинство корпоративных профилей ZCC App Profiles требуют одноразовый пароль ИТ для выхода из учётной записи или отключения Internet Security (ZIA), а команда sudo launchctl bootout system /Library/LaunchDaemons/com.zscaler.* блокируется или процессы немедленно перезапускаются.
  • Z-Tunnel 2.0 обходит системные настройки прокси: выключение переключателей HTTP/HTTPS-прокси Wi-Fi в «Системных настройках» macOS никак не влияет на перехват пакетов Z-Tunnel 2.0.
  • Потеря корпоративного доступа: даже если остановить ZCC, внутренние приложения ZPA (Zscaler Private Access) и корпоративный SSO с проверкой состояния устройства (Okta, Entra ID) перестанут работать.

3. Три практических способа работы с SSL-инспекцией Zscaler в macOS

Подход Кто управляет Сохраняет работу ZCC и корпоративного SSO? Лучший сценарий
Подоменный обход SWG (SWG bar) Локальный пользователь Mac (в разрешённых сетях) Да — направляет только выбранное имя хоста через физический IPv4-интерфейс Аппаратный Быстрое решение на уровне имени хоста для приложений с pinning, WebSockets или проблемных API разработки без отключения ZCC (Как обойти SWG на Mac)
Исключение в Zscaler Admin Portal (Do Not Inspect / App Profile) Служба ИТ / ИБ предприятия Да Постоянное общекорпоративное исключение в Policy → SSL Inspection → Do Not Inspect или в macOS App Profiles → Hostname/IP Bypass (Обход SWG и исключение TLS-инспекции)
Экспорт и доверие к Zscaler Root CA в инструментах CLI Локальный разработчик Да (трафик остаётся инспектируемым) Политика компании требует расшифровки, а git, npm, brew, Python, Claude Code или Cursor падают с unable to get local issuer certificate

4. Включите подоменный обход или настройте Zscaler Root CA для CLI

Вариант А: Подоменный обход через SWG bar (при наличии полномочий)

  1. Откройте SWG bar → Домены, найдите точное сбойное имя хоста (помните, что домены входа, API и CDN — это отдельные хосты; см. Обход SWG для многодоменных сценариев SSO, API и CDN) и нажмите Включить обход для этого домена рядом с Обойти SWG — либо выполните swgbar bypass enable <domain>.
  2. Дождитесь состояния Обход активен, затем перезапустите вкладку браузера, IDE или сеанс CLI, чтобы существующие сокеты переподключились по прямому маршруту IPv4 Аппаратный.
  3. Проверьте через swgbar probe <domain>, что теперь возвращается публичная цепочка сертификатов исходного сервера. Если межсетевой экран блокирует прямые исходящие соединения, выполните swgbar bypass disable <domain>, чтобы сразу восстановить обычную маршрутизацию через Zscaler.

Вариант Б: Настройте доверие к Zscaler Root CA в CLI и ИИ-инструментах

Если сетевая политика требует, чтобы трафик по-прежнему расшифровывался Zscaler, экспортируйте PEM-файл корневого CA Zscaler из «Связки ключей» (или запросите PEM у службы ИТ) и настройте среды выполнения вместо отключения проверки SSL:

# Node.js, npm, Claude Code, Cursor
export NODE_EXTRA_CA_CERTS="$HOME/.certs/zscaler-root.pem"

# Python (pip, requests), OpenSSL, Homebrew curl
export SSL_CERT_FILE="$HOME/.certs/zscaler-root.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"
export CURL_CA_BUNDLE="$HOME/.certs/zscaler-root.pem"

# Git
git config --global http.sslCAInfo "$HOME/.certs/zscaler-root.pem"

Полные инструкции для Homebrew, Docker Desktop, Python, Node.js, Claude Code и Cursor читайте в руководствах Настройка доверия к CA для Homebrew, Docker, Python и Node.js и Исправление ошибок сертификатов Claude Code и Cursor в macOS.