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