Доверие к 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-инспекции.