Открытая библиотека проверяет подписи агентов OpenAI

Regent Protocol 19 августа открыла под Apache-2.0 код regent-httpsig. Это библиотека на Python, которая работает с подписанным трафиком ИИ-агентов с обеих сторон: проверяет подписи HTTP-запросов по RFC 9421 и черновику Web Bot Auth, а заодно подписывает запросы вашего собственного агента, чтобы антибот-фильтры его узнавали. Агенты OpenAI, как сказано в репозитории проекта на GitHub, подписывают каждый свой запрос, а проверяют эти подписи Cloudflare, AWS WAF и Google. Авторы называют библиотеку проверенной в продакшне на их собственной платформе.
Главное в README не обёртка для FastAPI, а подробный список мест, где ломается совместимость: у OpenAI, у самого черновика стандарта и у библиотек, на которых всё держится.
Проверка в пять строк
Механика Web Bot Auth устроена просто. Запрос несёт три заголовка: Signature-Input перечисляет, какие части запроса подписаны, Signature содержит сами байты подписи, а Signature-Agent указывает HTTPS-адрес, где лежат публичные ключи. Проверяющая сторона скачивает каталог ключей по пути /.well-known/http-message-signatures-directory и сверяет подпись. Так устроено и у Cloudflare: по её документации, оператор бота генерирует ключ Ed25519, публикует его в формате JWK и отдаёт каталог по HTTPS.
В regent-httpsig для FastAPI достаточно подключить HttpsigVerifier к приложению и добавить зависимость в обработчик. Если подпись валидна, обработчик получает объект VerifiedSignature с полем agent (в примере это https://chatgpt.com) и keyid, отпечатком ключа по RFC 7638. Ядро от фреймворков не зависит: метод verify(method, url, headers) работает с любым асинхронным кодом.
По умолчанию проверка только добавляет сведения о запросе. Запрос без заголовка Signature ничего не стоит, плохая подпись даёт None, а на недоверенных входных данных библиотека не бросает исключений. Где подпись обязательна, есть RequiredSignatureDep: тогда агент получает 401 с указанием, как именно подписать запрос.
Отдельное предупреждение касается обратного прокси. Агент подписывает публичный URL вида https://api.example/…, а ASGI-сервер за nginx видит http://container/…, и подпись не сходится. Зависимость для FastAPI восстанавливает исходный URL из X-Forwarded-Proto и Host, поэтому прокси должен передавать схему; для nginx это proxy_set_header X-Forwarded-Proto $scheme;. Если подписи в продакшне вдруг перестали проверяться, советуют авторы, начинать стоит отсюда.
Как подписать своего агента
Обратная сторона - класс EgressSigner. Он принимает seed ключа из переменной окружения и адрес агента, а на выходе даёт заголовки, которые остаётся передать в httpx.post. Ключ и готовые файлы для /.well-known/ генерирует одна команда regent-httpsig keygen --agent https://myagent.example --out ./well-known/. После публикации каталога, обещают авторы, агента сможет опознать любой верификатор Web Bot Auth в интернете.
Ключ здесь и есть удостоверение. Раньше ботов опознавали по тому, что клиент сам о себе заявляет: строку user-agent легко подделать, и скраперы выдают себя за Googlebot, а проверки по IP и обратному DNS ломаются, когда оператор меняет инфраструктуру. В августе 2025 года Cloudflare описала незаявленный краулер Perplexity, который менял IP и ASN после того, как заявленного агента заблокировали. В Verified Bots Program у Cloudflare протокол появился 1 июля 2025 года, в тот же день, когда компания начала по умолчанию блокировать ИИ-краулеры, сообщает Crawlbase.
Два диалекта
Библиотека принимает оба формата заголовка Signature-Agent. Текущий черновик Web Bot Auth описывает его как структурированный словарь, но OpenAI в продакшне шлёт устаревшую форму, обычную строку. Поддержка обеих форм покрыта тестами в CI. В примере реестра каталогов, который Cloudflare представила 30 октября 2025 года, среди записей как раз значится https://chatgpt.com/.well-known/http-message-signatures-directory.
Второй диалект - AAuth (draft-hardt-oauth-aauth-protocol) в режиме идентификации. Агент передаёт JWT-токен в заголовке Signature-Key. JWKS издателя проверяет сам токен, а ключ из его поля cnf.jwk проверяет подпись запроса, и так подтверждается, что агент действительно владеет ключом. Ставится это дополнением pip install 'regent-httpsig[aauth]'. Реализация следует рабочей редакции -11: алгоритмы по RFC 9864 (Ed25519, с флагом перехода для экосистемы -10, где алгоритм назывался EdDSA) и токены пользователя aa-person+jwt, которые включаются через HttpsigConfig.resource_url. Полный протокол AAuth со всеми ролями и типами токенов авторы оставляют проекту christian-posta/aauth-python-library, свою библиотеку они описывают как тонкий верификатор на стороне ресурса.
Где ошибается наивная реализация
Каталог ключей верификатор скачивает с адреса, который выбирает тот, кто подписал запрос. Получается готовый вектор SSRF, атаки, при которой сервер ходит туда, куда его направил атакующий. Поэтому защита включена из коробки: только https, каждый разрешённый IP должен быть публичным (отсекаются 169.254.169.254, loopback, частные диапазоны и DNS-имена внутренних сервисов), редиректы не выполняются, размер ответа ограничен.
Кэш ключей ограничен и вытесняет старые записи, так что атака потоком новых keyid не раздует память. Неудачные запросы тоже кэшируются, чтобы мёртвый источник нельзя было использовать для замедления сервиса. И важная оговорка: валидная подпись доказывает только владение ключом, не благонадёжность. Поле VerifiedSignature.trusted отражает лишь ваш allow-list, а решать, доверять ли ключу, должен слой политик.
Настройка выглядит так: trusted_agents со значениями https://chatgpt.com и https://operator.openai.com, max_age_hours=25 (более старые подписи отклоняются) и cache_ttl=600 секунд для каталога ключей. Можно передать общий HTTP-клиент приложения, чтобы переиспользовать пул соединений.
Ошибки в чужих спецификациях
Таблица проверок в README идёт от байт-в-байт вектора Ed25519 из приложения B.2.6 RFC 9421 до отклонения подделанных запросов, просроченных подписей и чужих ключей каталога. Самая любопытная строка - сноска к примеру A.2.2 из черновика Web Bot Auth -05: байты подписи, напечатанные в черновике, не проходят проверку над его же базой подписи. Устаревший вектор A.2.3 и B.2.6 из RFC сходятся, поэтому, по выводу авторов, ошибка в самом примере, а не в канонизации. Ed25519 детерминирован, так что тест фиксирует вектор, заново подписанный тем же тестовым ключом RFC над той же базой. Об ошибке сообщили авторам черновика.
Проверка совместимости с библиотекой aauth-signing нашла сразу две вещи. Её подписанты корректно опускают необязательный параметр keyid, а нижележащая библиотека RFC 9421 читает его без всяких условий, и этот случай regent-httpsig теперь обрабатывает. Сама aauth-signing кодирует байты подписи в base64url, хотя RFC 8941 требует стандартный base64; об этом тоже сообщили. У pyauth/http-message-signatures, на которой построен проект, нашлись и другие острые углы: она не умеет разрешать члены словаря ;key=, ищет заголовки с учётом регистра, хотя ASGI-фреймворки приводят их к нижнему, и не объявляет зависимость от typing_extensions. Всё это закрыто обёртками.
Из ограничений авторы называют только Ed25519 (это то, что сейчас использует экосистема агентов) и проверку тела запроса через content-digest лишь тогда, когда тело покрыто подписью. Требовать этого библиотека не станет, решать придётся на каждом маршруте самому, и для эндпоинта /v1/orders из того же примера вопрос далеко не праздный.
RFC 9421 - финальный стандарт, а Web Bot Auth и AAuth остаются черновиками IETF. По состоянию на 18 августа Web Bot Auth, по сведениям Crawlbase, всё ещё индивидуальный черновик, который не приняла ни одна рабочая группа, хотя крупные фильтры трафика уже проверяют его в продакшне. Пока проект в версиях 0.x, ломающие изменения черновиков будут приходить минорными релизами.
Дальше
ClaudeИнструменты разработчика
budget-guard обрывает вызовы Claude на дневном лимите
budget-guard целится в инди-разработчиков, которые видели «счёт на $40 за задачу на $5». Обёртка над SDK Anthropic и OpenAI роняет вызов с ошибкой ровно на дневном лимите проекта.
Читайте также
- OpenAI нашла в Brotli дыру с удалённым выполнением кода
- OpenAI выложила проверку сайтов на уязвимость php2shell
- Битая картинка могла вскрыть Slack, Meta и GitHub
- Агенты OpenAI ломали RubyGems дырой, найденной в июле
- Fraggap: через баг ядра Linux агенты OpenAI взяли root
- Первичные оповещения в OpenAI разбирают модели
Комментарии
Пока никто не написал. Будьте первым.
Присоединяйтесь к разговору
Войдите, чтобы оставить комментарий. Он появится после модерации.

