Доверие к CA в Homebrew, Docker, Python и Node.js за SWG на Mac

Почему Homebrew, Docker Desktop, Node.js, Python, git и curl отклоняют TLS-сертификаты, подписанные SWG, в macOS — и как выбрать между пакетами CA и обходом SWG.

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

На корпоративном Mac за системой HTTPS break-and-inspect каждая среда разработки проверяет TLS-сертификаты по-своему. В то время как Safari и Chrome обращаются к Связке ключей macOS, инструменты CLI и контейнеры часто используют собственные пакеты сертификатов CA — что приводит к внезапным сбоям сборки в пакетных менеджерах и SDK.

Почему разные инструменты разработки на Mac ломаются выборочно

Инструмент / среда Хранилище доверия по умолчанию в macOS Типичная переменная окружения или параметр
Node.js / npm / yarn / pnpm Встроенный при сборке пакет CA Mozilla NODE_EXTRA_CA_CERTS=/path/to/corp-ca.pem
Python / pip / uv / requests Пакет certifi или путь к CA OpenSSL SSL_CERT_FILE / REQUESTS_CA_BUNDLE
git OpenSSL или Secure Transport в зависимости от сборки git config --global http.sslCAInfo /path/to/corp-ca.pem
curl / Homebrew (brew) macOS Secure Transport или пакет CA OpenSSL HOMEBREW_CURLRC / CURL_CA_BUNDLE (проверьте через curl --version)
Docker Desktop / контейнеры Linux VM и /etc/ssl/certs внутри образа (не Связка ключей macOS) Добавьте корпоративный CA в хранилище доверия Docker VM или образа

1. Определите, какой реестр или хост API перехватывается

Прежде чем менять профили оболочки или сборочные файлы контейнеров, убедитесь, какие именно внешние имена хостов проходят SSL-инспекцию, а не блокируются на уровне DNS или межсетевого экрана:

swgbar domains list --status confirmed
swgbar probe registry.npmjs.org
swgbar probe pypi.org
swgbar probe ghcr.io

Обратите внимание, что пакетные менеджеры часто перенаправляют загрузки между несколькими хостами (например, formulae.brew.sh → ghcr.io или github.com → objects.githubusercontent.com). См. Обход SWG для многодоменных веб-приложений, SSO, CDN и API.

2. Выберите между настройкой пакета CA, исключением TLS или обходом SWG

  • Добавьте PEM корпоративного корневого CA: если политика компании требует, чтобы весь трафик проходил расшифровку через SWG, экспортируйте точный корневой CA, найденный в SWG bar → Сертификаты, и настройте NODE_EXTRA_CA_CERTS, SSL_CERT_FILE, REQUESTS_CA_BUNDLE или http.sslCAInfo согласно рекомендациям службы ИБ. Никогда не отключайте проверку TLS (NODE_TLS_REJECT_UNAUTHORIZED=0 или sslVerify=false).
  • Запросите у ИТ-отдела исключение TLS-инспекции: рекомендуется для общих реестров, базовых образов Docker или инструментов со строгой привязкой сертификатов, где поддерживать пользовательские пакеты CA между CI и локальными машинами ненадёжно.
  • Используйте подоменный обход SWG в разрешённых сетях: если вы администрируете сеть или имеете полномочия обходить отдельные хосты на своём Mac, включите Обойти SWG в SWG bar (или выполните swgbar bypass enable <domain>) и перезапустите процесс CLI.

Сравните подходы перед изменением системных параметров

Пошаговое устранение ошибок CERTIFICATE_VERIFY_FAILED описано в руководстве Как исправить ошибки сертификатов TLS и SSL из-за SWG в CLI и ИИ на Mac. Подробное сравнение локальных правил маршрутизации и исключений политики на шлюзе приведено в статье Обход SWG и исключение TLS-инспекции.