Перейти к содержанию

OpenAI

Проверка сертификатов ломается после перехода на HTTPX2

4 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: OpenAI: модели и продукты →
Изображение: github.com

28 августа OpenAI перевела официальный Python-SDK на HTTPX2: синхронный и асинхронный клиенты теперь работают на нём. HTTPX2 ставится вместе с openai, а прежний пакет httpx SDK больше за собой не тянет. Что это меняет для кода, который работает с HTTP-слоем SDK, расписано в руководстве по миграции в репозитории openai-python на GitHub.

HTTPX2 продолжает HTTPX. Это форк httpx 0.28.1 с тем же публичным API (те же Client, AsyncClient, Response), и главное отличие в имени. В репозитории проекта Pydantic объясняет, что берёт его под опеку, потому что сам HTTPX в последнее время развивался вяло, а пользователям нужен надёжно поддерживаемый путь со своевременными обновлениями безопасности. httpx стал стандартным клиентом для целого поколения API-SDK, включая OpenAI, но работа над проектом замедлилась: issues и пул-реквесты копились без ревью.

Если клиент OpenAI или AsyncOpenAI создаётся без своего http_client, вызовы API, разобранные модели ответов, стриминг, аутентификация, повторы и числовые таймауты работают как раньше. Отдельно ставить ничего не нужно, хватает pip install openai. Ломается другое: если приложение импортировало httpx только потому, что его транзитивно ставил старый SDK, теперь эту зависимость надо прописать самим или перевести импорты на httpx2.

Сертификаты из системы

Самое заметное изменение касается и тех, кто не трогает HTTP-клиент вообще. HTTPX проверял сертификаты по набору корневых CA из пакета certifi. HTTPX2 вместо этого опирается на хранилище доверенных сертификатов операционной системы, а certifi SDK больше не устанавливает.

OpenAI прямо называет три сценария, где проверка сертификатов может перестать проходить: минимальные контейнерные образы без системных CA, корпоративные прокси, которые вскрывают TLS-трафик для инспекции, и развёртывания, где использовался свой или правленый набор certifi.

Варианта починки два. Первый: поставить нужные CA в системное хранилище. Второй: указать набор явно через SSL_CERT_FILE=/path/to/ca-bundle.pem или каталог с сертификатами через SSL_CERT_DIR. Обе переменные читаются при trust_env=True, а это значение по умолчанию. Для полного контроля на своём клиенте можно передать ssl.SSLContext через параметр verify: DefaultHttpx2Client(verify=ssl_context), для асинхронного кода DefaultAsyncHttpx2Client. Транспорт на aiohttp в SDK использует те же настройки TLS из HTTPX2.

Что переписывать в своём клиенте

Кто передаёт SDK собственный клиент, должен собирать его на HTTPX2. Хелперы DefaultHttpx2Client и DefaultAsyncHttpx2Client сохраняют рекомендованные SDK значения таймаутов, пула соединений и редиректов. Голые httpx2.Client и httpx2.AsyncClient тоже принимаются, но тогда действуют их собственные умолчания. Старые имена DefaultHttpxClient и DefaultAsyncHttpxClient по-прежнему работают, только создают уже клиенты HTTPX2. То же правило касается модульной настройки через openai.http_client.

Объекты конфигурации меняются один к одному: Client, AsyncClient, Timeout, URL, Limits, HTTPTransport, AsyncHTTPTransport и MockTransport берутся из httpx2 вместо httpx. Числовые таймауты и строковые URL остаются как есть. Подклассы транспортов, смонтированные транспорты, интеграции с прокси и инструментирование пула соединений должны работать с транспортными интерфейсами HTTPX2. Обработчики аутентификации и event hooks получают объекты запроса и ответа из HTTPX2, так что аннотации и базовые классы тоже придётся поменять. Сторонние средства трассировки, middleware и интеграции аутентификации должны поддерживать HTTPX2 явно.

Причина в том, что пакеты разные. По документации Pydantic, httpx2.Client и httpx.Client - разные классы, как и Response, Request, Timeout. Библиотека, которая проверяет isinstance против httpx.Client, отвергнет клиент HTTPX2, а httpx.HTTPError не поймается в except httpx2.HTTPError. Ставить оба пакета в одно окружение при этом можно, они не конфликтуют.

Разобранные модели ответов SDK не меняются. Но у нативного клиента сырые ответы через with_raw_response отдают httpx2.Response и httpx2.Request, неразобранный ответ запрашивается через cast_to=httpx2.Response, а обёртки стриминга тоже возвращают объекты HTTPX2. Ловить в коде OpenAI советует собственные исключения SDK вроде openai.APITimeoutError и openai.APIConnectionError, у которых транспортная первопричина теперь тоже из HTTPX2.

Тесты и RESPX

Моки должны перехватывать запросы HTTPX2 и возвращать ответы HTTPX2, например через httpx2.MockTransport с функцией-обработчиком. С RESPX, популярной библиотекой для подмены HTTP-запросов в тестах, придётся обновиться до совместимой с HTTPX2 версии или форка: версия, которая патчит только старый HTTPX, клиент SDK по умолчанию не перехватит.

Экстра openai[aiohttp] теперь использует транспорт, написанный под HTTPX2, и не ставит ни старый HTTPX, ни внешний адаптер httpx-aiohttp. DefaultAioHttpClient() возвращает обычный httpx2.AsyncClient.

Аварийный выход

Для тех, кто завязан на транспорт, интеграцию или моки, работающие только с HTTPX, оставлен обходной путь: поставить httpx вручную и передать его клиент в SDK. Поддержка есть только во время выполнения. Публичные аннотации SDK принимают лишь клиенты HTTPX2, поэтому mypy, Pyright и похожие инструменты на старом клиенте падают, и OpenAI предлагает обернуть его в cast(Any, httpx.Client()) или поставить точечный type-ignore. Такой клиент отдаёт запросы, ответы и исключения из семейства HTTPX, и cast_to=httpx2.Response не превращает старый ответ в новый. Тот же приём работает с существующей интеграцией httpx-aiohttp: по словам OpenAI, этот путь покрыт отдельными тестами совместимости, включая реальный запрос через транспорт aiohttp.

Старую зависимость придётся ставить и сопровождать самим. Срок у этого пути в руководстве не обещан:

Поддержка устаревшего HTTPX оставлена как подспорье для миграции и может быть прекращена.

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.