SSL-инспекция Netskope на Mac: проверка расшифровки и обход по доменам

Проверьте, расшифровывает ли Netskope Client HTTPS на вашем Mac (CA *.goskope.com), сравните подоменный обход SWG bar с политикой Do Not Decrypt и настройте nscacert_combined.pem.

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

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

Netskope Secure Web Gateway широко используется в корпоративных парках macOS с клиентом маршрутизации на базе NetworkExtension и промежуточным CA конкретного арендатора (tenant). Поскольку корневой CA Netskope устанавливается через MDM в «Связку ключей» macOS, браузеры показывают обычные действительные индикаторы безопасности, тогда как среды CLI (pip, npm, AWS CLI, git, Docker, Claude Code) и настольные приложения с привязкой сертификатов завершаются с ошибками CERTIFICATE_VERIFY_FAILED или UNABLE_TO_GET_ISSUER_CERT_LOCALLY.

1. Проверьте, расшифровывает ли Netskope нужный домен на вашем Mac

Проверьте как общесистемный перехват, так и отдельные имена хостов:

  • Наглядная проверка в строке меню и Chrome с SWG bar: установите SWG bar (macOS 14+ Apple silicon, бесплатная пробная версия на 14 дней использования), откройте сайт или повторите сбойную команду. Откройте SWG bar → Домены или выполните swgbar domains list --status confirmed, чтобы увидеть все имена хостов, чьи TLS-сертификаты были переподписаны CA вашего арендатора Netskope (обычно вида ca.<tenant>.goskope.com или корпоративного CA вашей компании). Дополнительно подключите бесплатное расширение SWG bar для Chrome, чтобы видеть индикаторы статуса прямо на панели инструментов браузера.
  • Проверка сертификатов Netskope и живого издателя в Терминале:
# Проверить, установлен ли CA Netskope в системной связке ключей macOS
security find-certificate -c "Netskope" /Library/Keychains/System.keychain

# Проверить издателя живого сертификата, возвращаемого для конкретного имени хоста
openssl s_client -connect registry.npmjs.org:443 -servername registry.npmjs.org </dev/null 2>/dev/null | openssl x509 -noout -issuer -subject

Помните, что политики Netskope часто расшифровывают одни SaaS-сервисы и хостинги кода, пропуская другие без изменений; всегда проверяйте именно то имя хоста, на котором возникает сбой.

2. Почему закрытие Netskope Client обычно не помогает

В управляемых средах с включённой политикой защиты от вмешательства Netskope Protect Client configuration and resources пункт Disable в значке Netskope в строке меню отключён или защищён паролем, а принудительная выгрузка демона ломает системную маршрутизацию сети. Очистка полей прокси Wi-Fi в macOS также не даёт эффекта, поскольку Netskope перенаправляет трафик на уровне NetworkExtension в macOS.

3. Выберите подходящий способ работы с Netskope в macOS

Способ Останавливает расшифровку Netskope? Требуются права администратора Netskope? Когда подходит лучше всего
Подоменный обход SWG (SWG bar) Да, для выбранных хостов через физический IPv4 Аппаратный Нет (локальное управление на авторизованном Mac) Приложение с pinning, WebSocket или конечная точка разработки ломается при расшифровке Netskope, и доступен прямой маршрут IPv4 (Как обойти SWG на Mac)
Исключение в тенанте Netskope Do Not Decrypt / Certificate Pinned Apps Да, централизованно на всех управляемых Mac Да (Policies → SSL Decryption → Do Not Decrypt или Steering Configuration → Exceptions) Общекорпоративные настольные приложения с pinning или общие эндпоинты разработки не работают у всей команды (Обход SWG и исключение TLS-инспекции)
Объединённый пакет CA (nscacert_combined.pem) для CLI Нет (трафик по-прежнему инспектируется) Нет Политика требует расшифрованной маршрутизации через Netskope, а инструментам CLI и ИИ достаточно доверять цепочке CA Netskope

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

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

  1. Откройте SWG bar → Домены, выберите точное проверяемое имя хоста (например, api.anthropic.com или pypi.org) и нажмите Включить обход для этого домена рядом с Обойти SWG — либо выполните swgbar bypass enable <domain>.
  2. Дождитесь появления статуса Обход активен, затем перезапустите вкладку браузера, консольную утилиту или IDE, чтобы существующие пулы соединений TLS и HTTP/3 переподключились через физический IPv4-интерфейс Аппаратный.
  3. Проверьте через swgbar probe <domain>, что теперь возвращается публичная цепочка сертификатов исходного сервера. Чтобы немедленно вернуть прежний маршрут, нажмите активную кнопку ещё раз или выполните swgbar bypass disable <domain>.

Вариант Б: Соберите объединённый PEM-файл для CLI под Netskope

Если трафик должен оставаться под инспекцией Netskope, экспортируйте объединённый PEM-пакет из хранилищ доверия macOS (либо используйте файл nscacert_combined.pem, предоставленный ИТ-службой) и подключите его для инструментов разработки в ~/.zshrc:

security find-certificate -a -p \
  /System/Library/Keychains/SystemRootCertificates.keychain \
  /Library/Keychains/System.keychain > "$HOME/.certs/nscacert_combined.pem"

export NODE_EXTRA_CA_CERTS="$HOME/.certs/nscacert_combined.pem"
export REQUESTS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"
export SSL_CERT_FILE="$HOME/.certs/nscacert_combined.pem"
export AWS_CA_BUNDLE="$HOME/.certs/nscacert_combined.pem"

Настройки для конкретных сред и инструментов см. в статьях Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ и Доверие к CA в Homebrew, Docker, Python и Node.js.