Корпоративный TLS-инспектор на машине разработчика: почему рвутся запросы через прокси
Содержание статьи
- Введение: почему https ломается именно у вас и именно на работе
- Основы: цепочка доверия, хранилища и что такое tls-инспекция
- Глубокое погружение: механика обрывов и неочевидные сценарии
- Метод 1: фреймворк диагностики за десять минут
- Метод 2: легальное получение корпоративного ca и установка в системные хранилища
- Метод 3: настройка доверия в инструментах разработчика
- Метод 4: контейнеры, wsl, ci и переменные прокси
- Типичные ошибки: что не нужно делать
- Инструменты и ресурсы
- Кейсы и результаты
- Faq: глубокие вопросы и ответы
- Заключение: от хаоса к процессу
Введение: почему HTTPS ломается именно у вас и именно на работе
Знакомая картина? Дома npm install отрабатывает за минуту, а в офисе падает с ошибкой self signed certificate in certificate chain. Python-скрипт, который годами ходил в API, вдруг выдает CERTIFICATE_VERIFY_FAILED. Docker не может стянуть образ, Git отказывается клонировать репозиторий, а Java пишет загадочное PKIX path building failed. И самое обидное: браузер при этом открывает те же адреса без единого предупреждения.
Мы с вами разберем эту ситуацию от начала до конца. Причина почти всегда одна: между вашей машиной и интернетом стоит TLS-инспектор. Это может быть корпоративный шлюз безопасности, локальный антивирус с модулем проверки веб-трафика или прокси-сервер с расшифровкой HTTPS. Он законно и по политике компании разворачивает зашифрованное соединение, проверяет содержимое и заворачивает обратно, подписывая трафик собственным сертификатом. Браузер этому сертификату доверяет, потому что администраторы заранее положили корпоративный корневой сертификат в системное хранилище. А ваши инструменты разработчика зачастую смотрят в совершенно другие хранилища и о корпоративном CA ничего не знают.
Важно сразу расставить акценты. Эта статья не про то, как избавиться от инспекции или спрятаться от нее. Инспекция трафика на рабочих машинах является нормальной практикой информационной безопасности, закрепленной в политиках компании и трудовых договорах. Наша задача другая: научиться быстро понимать, что именно происходит, и легально настроить доверие к своему же корпоративному удостоверяющему центру во всех инструментах, которыми вы пользуетесь. Это цивилизованный путь, который одобрит любая служба ИБ, потому что он сохраняет проверку сертификатов, а не отключает ее.
Что вы получите после прочтения:
- понимание, как устроена цепочка доверия TLS и почему у каждого инструмента свое хранилище сертификатов;
- фреймворк диагностики за десять минут: кто подменяет сертификат, где именно рвется соединение, какой инструмент виноват;
- пошаговые инструкции по установке корпоративного CA в Windows, macOS и Linux;
- готовые рецепты для Node.js, Python, Java, Git, curl, Go, .NET, Docker, WSL и CI-агентов;
- список типичных ошибок, за которые вас справедливо поругают на код-ревью и на аудите ИБ;
- реальные кейсы с цифрами и подробный FAQ.
По нашим наблюдениям, разработчик в компании с активной инспекцией трафика теряет от двух до шести часов в месяц на борьбу с сертификатами, если процесс не выстроен. Умножьте на команду из тридцати человек, и получится почти полная ставка инженера, которая уходит в никуда. Давайте вернем эти часы.
Основы: цепочка доверия, хранилища и что такое TLS-инспекция
Как работает доверие в TLS
Когда клиент открывает HTTPS-соединение, сервер предъявляет сертификат: электронный документ, где написано, какому доменному имени он выдан и кто его подписал. Подписавшая сторона называется удостоверяющим центром (Certificate Authority, CA). Сертификат сайта обычно подписан промежуточным CA, а тот в свою очередь подписан корневым CA. Получается цепочка сертификатов, и клиент проверяет ее снизу вверх, пока не доберется до корня, который уже лежит в его локальном хранилище доверенных корневых сертификатов.
Представьте, что вы принимаете паспорт. Вы не знаете лично человека, но доверяете ведомству, которое паспорт выдало, потому что образец печати этого ведомства у вас есть. Корневой сертификат и есть такой образец печати. Если печать незнакомая, документ отвергается, каким бы настоящим он ни выглядел.
Помимо цепочки клиент проверяет еще несколько вещей: соответствие имени в сертификате имени сервера (через поле Subject Alternative Name), срок действия, назначение ключа, отсутствие сертификата в списках отзыва. Любая из этих проверок может провалиться, но в контексте нашей темы почти всегда проваливается именно построение цепочки до доверенного корня.
Что делает TLS-инспектор
TLS-инспекция (ее еще называют SSL-инспекцией, расшифровкой HTTPS или TLS interception) работает так. Ваш клиент устанавливает соединение с example.com. Инспектор перехватывает это соединение, сам открывает TLS-сессию с настоящим example.com, проверяет его сертификат, а затем на лету генерирует новый сертификат для example.com, подписанный корпоративным CA, и предъявляет его вашему клиенту. Клиент видит сертификат с правильным именем, но подписанный не публичным центром, а корпоративным.
Если корпоративный корневой сертификат установлен в хранилище клиента, все проходит прозрачно. Если нет, клиент честно сообщает: цепочка ведет к неизвестному корню. Именно это и происходит с инструментами разработчика.
Кто может быть инспектором на вашей машине
- Корпоративный шлюз безопасности: облачный или локальный прокси класса Secure Web Gateway, межсетевой экран нового поколения с расшифровкой трафика. Работает на уровне сети или через агент на рабочей станции.
- Локальный антивирус или EDR: модуль веб-защиты многих антивирусов расшифровывает HTTPS прямо на машине, устанавливая свой корневой сертификат при установке продукта. Это самый частый и самый незаметный случай на ноутбуках сотрудников.
- Явный прокси-сервер: адрес прокси прописан в системе, PAC-файле или переменных окружения. Клиент отправляет запрос CONNECT, а прокси решает, расшифровывать соединение или пропустить как есть.
- Прозрачный прокси: клиент ни о каком прокси не знает, трафик перенаправляется на сетевом уровне. Диагностировать сложнее, потому что проксирование не видно в настройках.
- Отладочные инструменты: локальные перехватчики, которые сам разработчик поставил для отладки API, тоже ставят свой CA и иногда остаются включенными случайно.
Почему браузер работает, а терминал нет
Здесь кроется главное непонимание. Многие думают, что на компьютере есть одно хранилище сертификатов. На самом деле их может быть десяток. Браузеры на Windows и macOS используют системное хранилище, куда администраторы централизованно кладут корпоративный CA через групповые политики или профили управления. А вот Node.js приходит со своим встроенным набором корней и системное хранилище по умолчанию игнорирует. Python через библиотеку requests берет набор certifi. Java хранит корни в файле cacerts внутри установки JDK. Git на Windows может использовать либо OpenSSL со своим бандлом, либо системный Schannel. Docker daemon смотрит в свои каталоги. У каждого инструмента свой паспортный стол, и корпоративная печать есть только в одном из них.
Как только вы это осознаете, проблема перестает быть мистикой и превращается в инвентаризацию: перечислить все хранилища на машине и положить в каждое корпоративный корень.
Глубокое погружение: механика обрывов и неочевидные сценарии
Анатомия ошибок в разных стеках
Одна и та же причина выглядит по-разному в зависимости от языка и библиотеки. Полезно узнавать ее с первого взгляда.
- Node.js и npm: UNABLE_TO_GET_ISSUER_CERT_LOCALLY, SELF_SIGNED_CERT_IN_CHAIN, unable to verify the first certificate. Формулировка про самоподписанный сертификат вводит в заблуждение: сертификат сайта не самоподписан, просто корень цепочки неизвестен OpenSSL внутри Node.
- Python: SSL: CERTIFICATE_VERIFY_FAILED, unable to get local issuer certificate. Слово local здесь ключевое: локально нет издателя.
- Java, Maven, Gradle, Kotlin: PKIX path building failed: unable to find valid certification path to requested target. PKIX это стандарт инфраструктуры открытых ключей, а фраза означает буквально то же самое: путь до доверенного корня не построен.
- Go: x509: certificate signed by unknown authority. Go на Linux использует системное хранилище, поэтому после установки корня в систему обычно оживает первым.
- curl: SSL certificate problem: unable to get local issuer certificate, код ошибки 60.
- Git: те же ошибки от curl, потому что Git использует libcurl под капотом, либо SEC_E_UNTRUSTED_ROOT при использовании Schannel на Windows.
- .NET: The remote certificate is invalid according to the validation procedure: RemoteCertificateChainErrors.
- Docker: x509: certificate signed by unknown authority при pull или login в реестр.
Обрывы, которые не связаны с доверием
Вот где начинается по-настоящему интересное. Даже когда корневой сертификат установлен везде, запросы через инспектор могут рваться. И причины здесь уже не в криптографии доверия, а в том, что инспектор является полноценным посредником со своими ограничениями.
Пиннинг сертификатов. Некоторые клиенты жестко зашивают отпечаток ожидаемого сертификата или публичного ключа. Мобильные SDK, клиенты облачных провайдеров, некоторые пакетные менеджеры и мессенджеры так делают. При инспекции отпечаток не совпадает, соединение отвергается, и никакая установка корня не поможет. Единственный законный выход: попросить службу ИБ добавить этот домен в список исключений из расшифровки. Такие списки есть у любого серьезного шлюза, и производители инспекторов сами публикуют перечни сервисов, которые нельзя расшифровывать.
Протокольные ограничения посредника. Инспектор должен терминировать TLS у себя и поднять новое соединение. Если он не поддерживает HTTP/2, gRPC-стримы или WebSocket в полной мере, вы увидите не ошибку сертификата, а зависание, обрыв по таймауту, странные коды 502 или сброс длинных соединений через фиксированный интервал. Классический симптом: короткие REST-запросы работают, а gRPC-стрим или долгий WebSocket рвется ровно через 60 или 300 секунд.
Взаимная аутентификация mTLS. Если ваш сервис требует клиентский сертификат, инспектор физически не может его предъявить целевому серверу, потому что закрытый ключ у вас, а не у него. Соединение либо падает на рукопожатии, либо сервер отвечает 401. Домены с mTLS обязаны быть в исключениях, и это тоже задача для ИБ, а не для обхода.
Современные расширения TLS. К 2026 году ситуация обострилась. Браузеры и библиотеки массово внедрили гибридный постквантовый обмен ключами, а инспекторы старых поколений не понимают новые группы в ClientHello и обрывают рукопожатие. Аналогично с Encrypted Client Hello: часть шлюзов при обнаружении ECH принудительно откатывает соединение, а часть просто сбрасывает его. Протокол QUIC и HTTP/3 многие шлюзы блокируют целиком, заставляя клиент откатиться на TCP. Если ваша библиотека не умеет откатываться, запрос рвется без внятной ошибки.
Аутентификация на прокси. Явные корпоративные прокси часто требуют NTLM или Kerberos. Браузер проходит эту аутентификацию прозрачно от имени доменного пользователя, а Python или Node этого не умеют без дополнительных библиотек. Вы увидите 407 Proxy Authentication Required или зависание на CONNECT. Это не ошибка сертификата, но внешне выглядит как обрыв через прокси.
Несколько инспекторов одновременно. Иногда цепочка выглядит как матрешка: локальный антивирус подписывает трафик своим корнем, а выше стоит корпоративный шлюз со своим. В зависимости от того, кто первым перехватывает соединение, клиент видит разные корни. Устанавливать нужно оба, а лучше выяснить у ИБ, зачем два и не дублируют ли они друг друга.
Немного статистики и трендов
По отраслевым оценкам, свыше 90 процентов веб-трафика зашифровано, поэтому организации, желающие видеть содержимое, вынуждены применять расшифровку. Опросы служб ИБ последних лет показывают, что от половины до двух третей средних и крупных компаний расшифровывают хотя бы часть исходящего трафика рабочих станций. При этом доля запросов, генерируемых не браузерами, а инструментами командной строки, агентами CI, языковыми рантаймами и ИИ-ассистентами в редакторах кода, стремительно растет. Именно эти клиенты страдают от инспекции сильнее всего, потому что не используют системное хранилище и не умеют проходить прокси-аутентификацию. Еще один тренд: сокращение сроков жизни публичных сертификатов по дорожной карте отраслевого форума удостоверяющих центров до 200 дней в 2026 году и далее вниз. Инспекторы генерируют подменные сертификаты динамически, поэтому на них это почти не влияет, но клиентские кэши и агрессивные политики ротации иногда приводят к ситуациям, когда кэшированный сертификат уже отозван, а новый еще не выпущен.
Метод 1: фреймворк диагностики за десять минут
Прежде чем что-либо настраивать, нужно точно ответить на четыре вопроса: есть ли подмена сертификата, кто ее выполняет, идет ли трафик через явный прокси и какой именно инструмент не доверяет корню. Предлагаем последовательность, которую мы отработали на десятках рабочих станций.
Шаг 1. Убедитесь, что подмена действительно есть
Возьмите любой публичный домен и посмотрите, кто подписал его сертификат с вашей машины.
openssl s_client -connect example.com:443 -servername example.com -showcerts < /dev/null 2>/dev/null | openssl x509 -noout -issuer -subject -datesЕсли в поле issuer вы видите не публичный центр, а название вашей компании, антивируса или шлюза, подмена подтверждена. Для сравнения откройте тот же домен из браузера и посмотрите цепочку в информации о сертификате. Совпадение издателя между браузером и openssl означает, что подменяется весь трафик машины. Расхождение указывает, что инспектор действует избирательно или что openssl идет по другому маршруту.
Если на машине задан явный прокси, openssl нужно направить через него:
openssl s_client -proxy proxy.corp.local:8080 -connect example.com:443 -servername example.com -showcertsШаг 2. Определите, кто именно подменяет
Изучите поля subject и issuer подменного сертификата и корня. Названия обычно говорящие: там будет имя компании, название антивирусного продукта или название облачного шлюза. Дальше проверьте два признака.
- Если корень подписан именем антивируса и присутствует в системном хранилище с датой, совпадающей с установкой антивируса, инспектор локальный. Временно выключать защиту не нужно: достаточно понимать, что корень принадлежит продукту на вашей же машине.
- Если издатель совпадает с корпоративным CA, а в системе прописан прокси или установлен агент шлюза, инспектор сетевой. Проверьте настройки прокси командами
netsh winhttp show proxyна Windows,scutil --proxyна macOS или переменные окружения на Linux.
Шаг 3. Проверьте, где рвется соединение
Запустите curl с подробным выводом:
curl -v https://example.com -o /dev/nullЧитайте вывод сверху вниз. Строка про CONNECT и ответ 200 Connection established означает, что явный прокси принял туннель. Строки про TLS handshake и цепочку показывают, что именно предъявлено. Если curl доходит до SSL certificate problem, дело в доверии. Если он висит после CONNECT или получает 407, дело в аутентификации на прокси. Если рукопожатие обрывается сбросом соединения, подозревайте протокольные ограничения инспектора и попробуйте принудительно ограничить версию TLS или отключить HTTP/2 в тестовом запросе.
Шаг 4. Сопоставьте инструмент с его хранилищем
Ответьте, какое хранилище использует упавший инструмент. Для этого пригодится таблица в голове или чек-лист ниже. Затем проверьте наличие корня именно там. Например, для Python:
python -c "import ssl, certifi; print(ssl.get_default_verify_paths()); print(certifi.where())"Для Java посмотрите содержимое cacerts:
keytool -list -cacerts -storepass changeit | grep -i corpДля Node.js проверьте, задана ли переменная NODE_EXTRA_CA_CERTS и что она указывает на существующий файл.
Чек-лист диагностики
- Издатель сертификата публичного домена с вашей машины: публичный CA или корпоративный?
- Тот же домен в браузере: совпадает ли издатель?
- Явный прокси задан в системе, PAC-файле или переменных окружения?
- Установлен ли антивирус с модулем веб-защиты и есть ли его корень в системном хранилище?
- Ошибка звучит как проблема доверия, аутентификации прокси или обрыва рукопожатия?
- Какое хранилище использует упавший инструмент и есть ли там корпоративный корень?
- Работает ли тот же инструмент из другой сети или из контейнера? Это отделяет проблему машины от проблемы сети.
- Воспроизводится ли проблема на коллегах? Массовость указывает на изменение политики, единичность на локальную конфигурацию.
Наш инсайт: заведите в командной репозитории скрипт, который выполняет первые шесть пунктов и печатает отчет. Это экономит часы при онбординге новых сотрудников и при каждом обновлении корпоративного корня.
Метод 2: легальное получение корпоративного CA и установка в системные хранилища
Где взять правильный корневой сертификат
Правильный источник только один: служба информационной безопасности или ИТ-отдел вашей компании. Обычно корень публикуется на внутреннем портале, раздается через групповые политики или систему управления устройствами. Попросите файл в формате PEM или DER и запишите отпечаток SHA-256, который вам сообщили официально.
Извлечь корень из перехваченной цепочки технически возможно: команда openssl с флагом showcerts выведет всю цепочку, и последний сертификат будет корнем. Но относитесь к этому как к диагностическому приему, а не как к источнику доверия. Прежде чем устанавливать извлеченный корень, обязательно сверьте его отпечаток с официальным. Вы ведь не станете доверять печати, образец которой вам показал сам предъявитель документа? Сверка отпечатка занимает одну команду:
openssl x509 -in corp-root.pem -noout -fingerprint -sha256Для корня антивируса ситуация проще: продукт сам устанавливает его в системное хранилище при инсталляции, и вы можете экспортировать его оттуда. Экспортируйте только сертификат, не закрытый ключ, и убедитесь, что это именно корень, а не подменный сертификат конкретного сайта.
Windows
Корпоративный корень должен находиться в хранилище доверенных корневых центров сертификации на уровне компьютера, а не только пользователя. Проверить наличие можно в PowerShell:
Get-ChildItem Cert:\LocalMachine\Root | Where-Object { $_.Subject -like "*Corp*" }Если корня нет и вы имеете локальные права администратора, установить его можно командой:
certutil -addstore -f Root corp-root.cerВ корпоративной среде правильнее, чтобы это сделала групповая политика или система управления устройствами. Если вы видите, что корень отсутствует на управляемой машине, это повод сообщить администраторам, а не только чинить локально: значит, политика не применилась, и другие сотрудники столкнутся с той же проблемой.
macOS
На macOS корень добавляется в системную связку ключей и помечается как доверенный для SSL:
sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain corp-root.pemОбратите внимание на управляемые профили: если компания использует систему управления устройствами, корень приходит через профиль конфигурации, и удалять или изменять его вручную нельзя. Проверить доверие можно командой security verify-cert -c corp-root.pem или открыв Связку ключей и убедившись, что для сертификата задано доверие всегда.
Linux
Здесь два основных семейства. В Debian и Ubuntu файл копируется в каталог локальных сертификатов с расширением crt и обновляется общий бандл:
sudo cp corp-root.pem /usr/local/share/ca-certificates/corp-root.crt && sudo update-ca-certificatesВ RHEL, Fedora, Rocky и Alma используется другой каталог и другая команда:
sudo cp corp-root.pem /etc/pki/ca-trust/source/anchors/ && sudo update-ca-trust extractПосле этого системный бандл обновится, и все инструменты, использующие OpenSSL с системными путями, начнут доверять корню. Это covers curl, Git, Go, wget и большинство пакетных менеджеров дистрибутива. Но не Python с certifi, не Node.js и не Java: они живут своей жизнью, и к ним мы переходим дальше.
Чек-лист установки в систему
- Корень получен из официального источника, отпечаток сверен.
- Установлен в хранилище уровня машины, не только пользователя.
- Установлен именно корневой сертификат, а не промежуточный и не подменный сертификат сайта.
- Проверено командой openssl или curl, что публичный домен теперь открывается без ошибок.
- Если инспекторов два, установлены оба корня.
- Записано, где лежит файл корня, чтобы ссылаться на него из настроек инструментов.
Метод 3: настройка доверия в инструментах разработчика
Теперь самое объемное. Каждому инструменту нужно объяснить, где взять корпоративный корень. Общая стратегия: сформировать один файл в формате PEM, содержащий системные корни плюс корпоративный, положить его в фиксированное место и ссылаться на него отовсюду. На Linux после update-ca-certificates таким файлом становится системный бандл. На macOS и Windows его придется собрать самостоятельно: экспортировать бандл certifi или Mozilla, дописать в конец корпоративный корень и сохранить, например, в каталог профиля пользователя.
Node.js и npm
Node.js хранит корни внутри бинарника и системное хранилище по умолчанию не читает. Самый чистый способ: переменная окружения NODE_EXTRA_CA_CERTS, указывающая на PEM-файл с корпоративным корнем. Она добавляет корень к встроенному набору, а не заменяет его.
export NODE_EXTRA_CA_CERTS=/home/user/certs/corp-root.pemВ новых версиях Node появился флаг --use-system-ca и соответствующая переменная NODE_USE_SYSTEM_CA=1, позволяющие читать системное хранилище напрямую. Если ваша версия его поддерживает, это избавляет от отдельного файла. Для npm задайте параметр cafile, потому что npm читает конфигурацию из своего файла и переменную Node учитывает не всегда:
npm config set cafile /home/user/certs/corp-root.pemYarn и pnpm имеют аналогичные параметры. Никогда не используйте strict-ssl false и NODE_TLS_REJECT_UNAUTHORIZED=0: об этом отдельно в разделе ошибок.
Python, pip, requests и другие
Стандартный модуль ssl в Python на Linux использует системные пути OpenSSL и после update-ca-certificates заработает сам. Но библиотека requests и все, что на ней построено, берет бандл из пакета certifi. Решений несколько, от простого к правильному.
- Переменная
REQUESTS_CA_BUNDLE, указывающая на объединенный PEM-файл. Влияет только на requests. - Переменная
SSL_CERT_FILE, влияет на модуль ssl, httpx, aiohttp и многие другие библиотеки. - Для pip:
pip config set global.cert /path/to/bundle.pem. Так корень будет использоваться при установке пакетов из внутреннего или внешнего индекса. - Пакет truststore: одна строка
import truststore; truststore.inject_into_ssl()в начале программы заставляет Python использовать системное хранилище ОС. Современные версии pip умеют это включать автоматически. Это самый элегантный путь для macOS и Windows, потому что не требует собирать собственный бандл.
Для инструментов вроде Poetry, uv и conda есть свои параметры, но почти все они уважают SSL_CERT_FILE, поэтому глобальная переменная закрывает большинство случаев.
Java, Maven, Gradle
JVM хранит корни в файле cacerts внутри установки. Начиная с Java 9 можно импортировать напрямую в системный cacerts без указания пути:
keytool -importcert -cacerts -storepass changeit -alias corp-root -file corp-root.pem -nopromptПомните, что у вас может быть несколько JDK: системный, тот, что тянет IDE, тот, что скачал Gradle через toolchains. В каждый придется импортировать отдельно, либо использовать общий truststore через параметры -Djavax.net.ssl.trustStore и -Djavax.net.ssl.trustStorePassword, прописанные в переменной JAVA_TOOL_OPTIONS. Есть и хитрость для Windows: параметр -Djavax.net.ssl.trustStoreType=Windows-ROOT заставляет JVM читать системное хранилище напрямую. Для macOS аналогично работает тип KeychainStore. Maven и Gradle наследуют настройки JVM, но у Gradle daemon переменные нужно прописывать в gradle.properties через org.gradle.jvmargs, иначе демон запустится без них.
Git и curl
Git использует libcurl. На Linux после установки корня в систему все работает. На Windows Git for Windows умеет два бэкенда: OpenSSL со своим бандлом и Schannel, читающий системное хранилище. Переключение на Schannel решает проблему одной командой:
git config --global http.sslBackend schannelАльтернатива для любой ОС: указать путь к бандлу через git config --global http.sslCAInfo /path/to/bundle.pem. Для curl задайте переменную CURL_CA_BUNDLE или пропишите cacert=/path/to/bundle.pem в файле .curlrc в домашнем каталоге.
Go, Rust, .NET, Ruby, PHP
- Go на Linux и macOS читает системное хранилище, на Windows тоже. Дополнительно уважает
SSL_CERT_FILEиSSL_CERT_DIR. Обычно после системной установки оживает без действий. - Rust: библиотеки на native-tls используют систему, а на rustls с webpki-roots несут свои корни. Многие утилиты, включая cargo, уважают
SSL_CERT_FILE. Для cargo также можно включить системные корни через параметр конфигурации. - .NET на Windows и macOS использует системное хранилище. На Linux читает системный бандл OpenSSL, а также каталог, указанный в
SSL_CERT_DIR. - Ruby использует OpenSSL и системные пути, но gem может тянуть собственный бандл. Переменная
SSL_CERT_FILEзакрывает большинство случаев. - PHP: параметры openssl.cafile и curl.cainfo в php.ini.
Универсальный профиль окружения
Чтобы не держать все в голове, соберите блок переменных в профиле оболочки. На Linux и macOS это может выглядеть так:
export CORP_CA_BUNDLE=$HOME/certs/corp-bundle.pem
export SSL_CERT_FILE=$CORP_CA_BUNDLE
export REQUESTS_CA_BUNDLE=$CORP_CA_BUNDLE
export NODE_EXTRA_CA_CERTS=$HOME/certs/corp-root.pem
export CURL_CA_BUNDLE=$CORP_CA_BUNDLE
export GIT_SSL_CAINFO=$CORP_CA_BUNDLEНа Windows аналогичные переменные задаются через свойства системы или PowerShell-профиль. Важная деталь: для Node переменная должна указывать только на корпоративный корень, а не на полный бандл, потому что встроенные корни Node уже содержит и дублирование лишь замедлит старт. Для остальных инструментов нужен полный бандл, иначе они потеряют доверие к публичным центрам.
Метод 4: контейнеры, WSL, CI и переменные прокси
Docker: демон против контейнера
С Docker есть два независимых уровня. Первый: сам демон Docker, который скачивает образы из реестра. Он не читает переменные пользователя. На Linux демон использует системный бандл хоста, поэтому после update-ca-certificates нужно перезапустить службу docker. Для доверия конкретному реестру существует каталог сертификатов демона:
/etc/docker/certs.d/registry.corp.local/ca.crtВ Docker Desktop на Windows и macOS демон живет в виртуальной машине, но Docker Desktop автоматически синхронизирует доверенные корни хоста внутрь этой машины. Если это не сработало, перезапуск Docker Desktop после установки корня обычно решает вопрос.
Второй уровень: процессы внутри контейнера. Образ с минимальным дистрибутивом не знает о вашем корпоративном корне, и любой pip install или npm install внутри сборки упадет. Решения:
- Скопировать корень в образ на этапе сборки и выполнить update-ca-certificates. Делать это лучше в отдельном промежуточном образе или через build argument, чтобы не зашивать в публично распространяемые образы корпоративные артефакты.
- Использовать секреты сборки BuildKit для передачи корня только на время сборки:
RUN --mount=type=secret,id=corp_ca .... Так корень не остается в слоях образа. - Для запущенных контейнеров разработки монтировать файл корня томом и задавать переменные окружения из предыдущего раздела.
- В devcontainers прописать монтирование и переменные в конфигурации, чтобы каждый участник команды получал одинаковую среду.
Прокси-переменные HTTP_PROXY, HTTPS_PROXY и NO_PROXY для демона задаются в его собственной конфигурации или через systemd drop-in, а для контейнеров передаются при сборке и запуске. Не забудьте включить в NO_PROXY внутренние адреса, localhost и адреса кластера, иначе запросы к соседним контейнерам пойдут через корпоративный прокси и упадут.
WSL2
WSL2 это отдельная Linux-машина со своим хранилищем. Корень, установленный в Windows, туда не попадает автоматически. Нужно скопировать PEM-файл в дистрибутив и выполнить update-ca-certificates, а затем настроить инструменты как на обычном Linux. Некоторые корпоративные конфигурации WSL синхронизируют корни через скрипт запуска, но полагаться на это без проверки не стоит. Также помните, что сетевой режим WSL2 может отличаться, и явный прокси Windows не применяется автоматически: переменные окружения задаются отдельно.
CI-агенты и раннеры
Раннеры внутри корпоративной сети испытывают те же проблемы, но диагностировать их сложнее, потому что нет интерактивного доступа. Практические правила:
- Устанавливать корпоративный корень в базовый образ раннера или на хост раннера централизованно, а не в каждом пайплайне.
- Задавать переменные доверия на уровне конфигурации раннера, чтобы они наследовались всеми задачами.
- Хранить бандл как артефакт в защищенном хранилище конфигурации, а не в репозитории с кодом.
- Добавить в пайплайн шаг диагностики, который печатает издателя сертификата тестового домена: при смене корня вы увидите это до массового падения сборок.
Прокси-переменные, PAC и аутентификация
Явный прокси создает свой класс проблем, не связанных с сертификатами. Инструменты командной строки не читают PAC-файлы, поэтому адрес прокси нужно задать явно. Формат HTTPS_PROXY=http://proxy.corp.local:8080 означает, что к прокси клиент подключается по HTTP и просит туннель CONNECT до HTTPS-цели. Это нормально и не означает отсутствие шифрования. Регистр переменных имеет значение: некоторые инструменты читают только нижний регистр, некоторые только верхний, поэтому задавайте оба.
Если прокси требует доменную аутентификацию, инструменты вроде pip и npm не смогут пройти ее самостоятельно. Легальные варианты: попросить ИТ выделить учетную запись или режим без аутентификации для доверенных машин разработчиков, либо использовать локальный агент, который компания официально предоставляет для проброса аутентификации. Самостоятельно поднимать нечто подобное без согласования не стоит: с точки зрения ИБ это выглядит как попытка скрыть трафик.
Когда правильный ответ: исключение из инспекции
Существует категория трафика, которая принципиально не работает через расшифровку, и настраивать доверие тут бессмысленно. Это сервисы с пиннингом, mTLS, некоторые протоколы обновления ПО, отдельные облачные API с проверкой отпечатков. У любого корпоративного шлюза есть список исключений, и его пополнение является штатной процедурой. Оформите заявку в ИБ с указанием доменов, назначения, объема трафика и обоснования. По нашему опыту, грамотно оформленная заявка согласуется за один-три рабочих дня, а попытки решить вопрос самостоятельно заканчиваются инцидентом.
Типичные ошибки: что не нужно делать
Отключать проверку сертификатов
Самая распространенная и самая опасная ошибка. verify=False в Python, NODE_TLS_REJECT_UNAUTHORIZED=0, git config http.sslVerify false, curl -k, npm config set strict-ssl false. Это как выбросить замок с двери, потому что ключ не подошел. Вы не просто пускаете инспектор, вы пускаете кого угодно. Такие настройки имеют свойство утекать в код, в докерфайлы и в CI, а потом в продакшен. Аудиторы ИБ ищут их автоматическими сканерами, и находки классифицируются как критические.
Доверять первому попавшемуся корню
Извлечь корень из цепочки и сразу установить без сверки отпечатка с официальным источником. Если в момент извлечения вы сидели в недоверенной сети, вы могли установить чужой корень и открыть себе полноценный перехват на годы вперед.
Устанавливать в пользовательское хранилище вместо машинного
Часть служб и инструментов работает от других учетных записей и не видит корень, установленный только для вашего пользователя. Отсюда загадочные ситуации, когда в терминале все работает, а служба или планировщик падают.
Заменять бандл вместо дополнения
Если прописать в SSL_CERT_FILE файл, содержащий только корпоративный корень, инструмент потеряет доверие ко всем публичным центрам. Вне офиса, где инспекции нет, все перестанет работать. Бандл должен включать и публичные корни, и корпоративный.
Зашивать корень в исходный код и публичные образы
Корпоративный корень в репозитории или в слоях образа, который потом уходит в публичный реестр, это утечка информации о внутренней инфраструктуре. Используйте секреты сборки и внешнюю конфигурацию.
Не различать несколько инспекторов
Установили корень антивируса, а через неделю компания включила облачный шлюз со своим корнем, и все повторилось. Держите скрипт диагностики под рукой и проверяйте издателя при каждом новом сбое, а не предполагайте, что причина прежняя.
Настраивать каждый инструмент по отдельности без единого источника
Разбросанные по системе копии корня с разными датами приводят к тому, что после ротации корня половина инструментов обновилась, а половина нет. Одна папка, один бандл, ссылки отовсюду.
Игнорировать ротацию
Корпоративные корни обновляются: срок действия истекает, меняется алгоритм, меняется поставщик шлюза. Подпишитесь на рассылку ИТ-отдела или добавьте проверку срока действия корня в скрипт диагностики. Обрыв работы всей команды в день истечения корня это классический, полностью предотвратимый инцидент.
Чинить проблему, которую должна чинить ИБ
Если сервис с пиннингом не работает через инспекцию, никакие манипуляции с хранилищами не помогут. Тратить на это день бессмысленно. Оформляйте заявку на исключение.
Инструменты и ресурсы
Диагностика
- OpenSSL: s_client для просмотра цепочки, x509 для разбора сертификата, verify для проверки цепочки против бандла. Есть везде, работает одинаково.
- curl с флагом -v: показывает и прокси-этап, и рукопожатие, и цепочку. Флаг --cacert для проверки конкретного бандла без изменения настроек.
- certutil и PowerShell на Windows, security на macOS, trust и update-ca-certificates на Linux для работы с системными хранилищами.
- Wireshark или tcpdump: когда нужно увидеть, доходит ли рукопожатие до сервера, кто первым шлет сброс, откатывается ли соединение с HTTP/3 на TCP. Расшифровывать трафик не требуется, достаточно смотреть на ClientHello и ServerHello.
- keytool для Java-хранилищ, с флагом -list для инвентаризации и -importcert для добавления.
Управление доверием
- truststore для Python: подключение системного хранилища одной строкой.
- step-cli и подобные утилиты для работы с сертификатами: удобный просмотр, проверка, конвертация форматов между PEM, DER, PKCS12.
- mkcert для локальной разработки: создает локальный CA для ваших собственных тестовых доменов и корректно устанавливает его во все хранилища. Хороший пример того, как выглядит правильно сделанная инсталляция корня, и удобный способ понять, где какое хранилище находится.
- Системы управления конфигурацией для централизованной раскатки бандла на машины разработчиков и раннеры.
Чек-лист хранилищ на одной машине
Держите этот список как шпаргалку и отмечайте, куда корень уже установлен:
- Системное хранилище ОС на уровне машины.
- Системный бандл OpenSSL на Linux.
- Node.js через NODE_EXTRA_CA_CERTS или системный режим.
- npm, yarn, pnpm через cafile.
- Python: SSL_CERT_FILE, REQUESTS_CA_BUNDLE, pip cert или truststore.
- Каждая установленная JVM: cacerts или общий truststore.
- Git: sslBackend или sslCAInfo.
- curl: CURL_CA_BUNDLE или .curlrc.
- Docker daemon и certs.d.
- Базовые образы контейнеров и devcontainers.
- WSL2 дистрибутивы.
- IDE и их встроенные JVM или Node.
- Пакетные менеджеры экосистем: cargo, gem, composer, nuget, go modules proxy.
Кейсы и результаты
Кейс 1. Финтех, 120 разработчиков, внедрение облачного шлюза
Компания включила расшифровку трафика на всех ноутбуках в течение одной ночи. Утром служба поддержки получила более 80 обращений за первые два часа: не работали npm, pip, Maven и Docker. Браузеры работали, потому что корень был раскатан групповой политикой. Анализ показал, что ни один из инструментов разработки не читал системное хранилище. Решение заняло два дня: собрали единый бандл, написали скрипт установки для трех ОС, добавили переменные окружения в стандартный образ рабочей станции, импортировали корень в cacerts всех JDK через скрипт, обновили базовые образы контейнеров. Итог: число обращений упало до нуля за неделю, а последующая ротация корня через год прошла с двумя обращениями вместо восьмидесяти. Подсчитанные потери первого дня превысили 300 человеко-часов, стоимость системного решения составила около 40 часов.
Кейс 2. Антивирус на ноутбуке фрилансера-подрядчика
Разработчик работал удаленно на своем ноутбуке с установленным антивирусом. Все инструменты работали, кроме одного Go-сервиса, который ходил в облачный API и падал с ошибкой unknown authority. Оказалось, что антивирус подменял сертификаты выборочно, только для доменов, которых не было в его белом списке, а Go читал системное хранилище, где корень антивируса присутствовал. Почему тогда падение? Сертификат антивируса был выдан с устаревшим алгоритмом подписи, который новая версия Go перестала принимать. Обновление антивируса до актуальной версии, которая выпускает корень с современным алгоритмом, устранило проблему. Урок: инспектор тоже нуждается в обновлении, и сообщение об этом производителю или ИТ-отделу иногда важнее любых настроек на стороне клиента.
Кейс 3. gRPC-стримы рвутся ровно через пять минут
Команда разрабатывала микросервисы с долгими серверными стримами. В офисе стримы обрывались через 300 секунд, дома работали часами. Сертификаты были в порядке. Захват трафика показал, что корпоративный шлюз закрывал соединения без активности по таймауту, а grpc keepalive не был настроен. Решение оказалось двусторонним: включили клиентский keepalive с интервалом менее таймаута и согласовали с ИБ вынесение внутренних адресов разработки в исключения из инспекции, поскольку эти сервисы использовали mTLS. Время на диагностику до захвата трафика составило три дня, после захвата решение нашлось за час. Вывод: не задерживайтесь на гипотезе о сертификатах, если издатель уже проверен и корень установлен.
Кейс 4. CI-раннеры в контурe заказчика
Интегратор развернул раннеры в сети заказчика с прозрачной инспекцией. Пайплайны падали на этапе скачивания зависимостей. Первый инженер решил проблему через отключение проверки в конфигурации npm и pip. Через две недели сканер ИБ заказчика нашел эти настройки, инцидент вышел на уровень руководства проекта, и доступ раннеров был приостановлен на четыре дня. Исправление: корень заказчика установлен в образ раннера через секрет сборки, переменные доверия заданы на уровне конфигурации раннера, добавлен шаг проверки издателя. Стоимость ошибки: четыре дня простоя команды из восьми человек и потерянное доверие заказчика. Стоимость правильного решения: полдня работы.
FAQ: глубокие вопросы и ответы
Законно ли вообще, что компания расшифровывает мой трафик?
На корпоративных устройствах и в корпоративной сети инспекция трафика является стандартной мерой защиты, которая закрепляется во внутренних политиках, с которыми сотрудник знакомится при трудоустройстве. Компания обязана уведомить об этом, и обычно так и происходит. Инспекция защищает от утечек данных, вредоносного ПО и фишинга. Для личных нужд следует использовать личные устройства и сети, а не пытаться изменить поведение корпоративных средств защиты.
Как понять, антивирус подменяет сертификат или сетевой шлюз?
Смотрите на издателя подменного сертификата. Корень антивируса содержит название продукта и присутствует в системном хранилище с датой установки продукта. Корень шлюза содержит название компании или поставщика шлюза. Дополнительный признак: подмена антивирусом происходит и вне корпоративной сети, например дома, а подмена шлюзом только внутри сети или при включенном агенте. Проверьте один и тот же домен из офиса и из дома и сравните издателей.
Почему браузер показывает замок, а curl ругается, если корень один и тот же?
Потому что браузер читает системное хранилище, а curl на macOS и Windows, собранный с OpenSSL, использует собственный бандл. На Linux curl обычно читает системный бандл, и после update-ca-certificates проблема исчезает. На других ОС нужно указать бандл через CURL_CA_BUNDLE или .curlrc либо использовать сборку curl с системным бэкендом TLS.
Я установил корень в систему, но Python все равно падает. Что не так?
Библиотека requests использует бандл пакета certifi, а не системное хранилище. Задайте REQUESTS_CA_BUNDLE или SSL_CERT_FILE на объединенный бандл, либо подключите пакет truststore, который переводит Python на системное хранилище. Также проверьте, что виртуальное окружение не тянет свою копию certifi с другим путем: команда python -c с выводом certifi.where() покажет реальный путь.
Можно ли просто добавить корень в бандл certifi внутри site-packages?
Технически можно, но это плохая практика: при любом обновлении пакета изменения потеряются, а в каждом виртуальном окружении бандл свой. Используйте переменные окружения или truststore. Единый файл бандла в фиксированном месте с переменными, указывающими на него, надежнее и прозрачнее для коллег.
Что делать с инструментами, которые не поддерживают ни системное хранилище, ни переменные окружения?
Сначала проверьте документацию: почти у всех есть параметр для указания бандла, пусть и с нестандартным названием. Если действительно нет, обратитесь в ИБ с запросом на исключение целевых доменов из инспекции, либо рассмотрите замену инструмента. Отключение проверки сертификатов не является приемлемым вариантом даже временно.
Как настроить доверие в Docker-образах, не оставляя корень в публичных слоях?
Используйте секреты сборки BuildKit: монтируйте корень на время выполнения команды установки зависимостей, а после завершения команды он не сохраняется в слое. Альтернатива: многоэтапная сборка, где зависимости скачиваются на первом этапе с корнем, а в финальный образ копируются только результаты. Для публикуемых образов это обязательное требование.
Как заранее узнать о ротации корпоративного корня, чтобы не сломать всю команду?
Включите в скрипт диагностики проверку срока действия установленного корня и предупреждение за 60 дней. Договоритесь с ИТ-отделом о рассылке уведомлений об изменениях PKI. Добавьте в CI шаг, который сравнивает отпечаток текущего издателя тестового домена с ожидаемым и предупреждает при расхождении: так вы узнаете о смене корня в день ее проведения.
Инспекция замедляет работу? Стоит ли просить исключения для ускорения?
Инспекция добавляет задержку на дополнительное рукопожатие и проверку содержимого, обычно от десятков до сотен миллисекунд на соединение. Для интерактивной разработки это редко критично. Заметное замедление возникает при большом числе коротких соединений, например при установке тысяч мелких пакетов. Правильное решение здесь не исключение, а внутреннее зеркало пакетов или кэширующий прокси-репозиторий, который компания разворачивает официально: он и ускоряет, и снижает нагрузку на шлюз, и повышает надежность сборок.
Что изменится в ближайшие годы?
Рантаймы движутся к использованию системного хранилища по умолчанию: Node уже получил такой режим, Python через truststore, Java через типы хранилищ ОС. Это упростит жизнь. С другой стороны, постквантовые алгоритмы, Encrypted Client Hello и HTTP/3 создадут новые классы несовместимостей с инспекторами, и разработчикам придется чаще различать проблемы доверия и проблемы протокола. Также растет доля трафика от ИИ-агентов и автономных инструментов в редакторах, которые нужно будет так же аккуратно настраивать, как и классические пакетные менеджеры.
Заключение: от хаоса к процессу
Давайте подведем итоги. Обрыв HTTPS-запросов через корпоративный прокси или локальный инспектор в подавляющем большинстве случаев сводится к одной причине: инструмент разработчика не знает о корпоративном корневом сертификате, потому что смотрит не в системное хранилище, а в свое собственное. Реже причина в протокольных ограничениях посредника, пиннинге, mTLS или аутентификации на прокси. Разделить эти случаи помогает простая диагностика: посмотреть издателя сертификата, прочитать подробный вывод curl, сопоставить инструмент с его хранилищем.
Правильное решение всегда одно: сохранить проверку сертификатов и добавить доверие к своему же корпоративному CA, полученному из официального источника и сверенному по отпечатку. Единый бандл в фиксированном месте, переменные окружения, импорт в cacerts каждой JVM, корректная настройка Docker, WSL и раннеров. Все, что не решается доверием, решается заявкой в службу ИБ на исключение из инспекции. Все, что решается отключением проверки, не решается вовсе, а лишь откладывает инцидент.
Что сделать уже сегодня:
- Запустить openssl s_client на любой публичный домен и записать издателя. Это ваша точка отсчета.
- Получить официальный корень у ИТ или ИБ, сверить отпечаток, сохранить в личный каталог сертификатов.
- Собрать объединенный бандл и прописать переменные окружения из этой статьи в профиль оболочки.
- Пройти чек-лист хранилищ и отметить, куда корень уже установлен.
- Написать скрипт диагностики и положить его в командный репозиторий инструментов.
- Составить список сервисов, которые не работают через инспекцию по принципиальным причинам, и оформить заявку на исключения.
- Договориться о процессе уведомления о ротации корня.
Разве не удивительно, что проблема, которая ежемесячно съедает часы у тысяч разработчиков, решается одним аккуратно настроенным файлом и десятком строк конфигурации? Инвестируйте эти несколько часов один раз, поделитесь результатом с командой, и корпоративная инспекция трафика перестанет быть источником раздражения, оставшись тем, чем должна быть: невидимым слоем защиты, который не мешает работать.