Защитная памятка по langgraph-api и GHSA-jfj5-wrj9-63x4: граница версий, безопасный synthetic-тест, матрица наблюдений, stop-критерий, канарейка, возврат и очищенный пакет владельцу без опасного payload.
Решение для langgraph-api
Здесь важен не яркий симптом, а граница между затронутой и защищённой поставкой. Карточка advisory GHSA-jfj5-wrj9-63x4 подтверждает следующий технический класс: run-creation path отправлял иной authorization event с неполным ресурсным контекстом, чем прямое чтение assistant и cron path. Эта запись очерчивает область версий — версии langgraph-api ниже 0.10.0; patched-версия 0.10.0 — но не говорит, установлен ли компонент у конкретной команды и достижим ли проблемный путь. Отсюда следует: стартовый статус всегда unknown. Его меняют только на следующем шаге сопоставления фактически загруженного runtime, включённой функции и evidence из первичного первичной страницы. Прикладной вопрос формулируется без обещаний: можно ли безопасно показать, что исправленный langgraph-api сохраняет штатную функцию и закрывает именно описанную границу? Ответ нельзя строить по одному номеру в manifest, тишине журнала или зелёному health-check. Рабочий лист именно для этой темы разворачивает цепочку без универсальных подстановок. Зафиксированный механизм: run-creation path отправлял иной authorization event с неполным ресурсным контекстом, чем прямое чтение assistant и cron path. Версионная отсечка: версии langgraph-api ниже 0.10.0; patched-версия 0.10.0. Локальная процедура наблюдения: в тестовом tenant создать двух пользователей и по одному пустому assistant; каждый запускает свой объект, затем user A запрашивает run для assistant B без инструментов и данных. Её нормальный защитный исход: свой run создаётся, чужой не принят тем же policy decision, audit содержит assistant identity и tenant. Недопустимое расширение опыта сформулировано заранее: нужен реальный thread, пользовательские сообщения, платный model call или расширение прав тестовой роли. Для на следующем шагедующей независимой сверки владелец заполняет поля «caller | tenant | assistant owner | auth event | run id | outcome» и выполняет remediation «обновить langgraph-api до 0.10.0 или новее и унифицировать policy для read, cron и run creation». Эта связка данных связывает причину, версию, измерение, отказ, сохранение функции и возврат именно для langgraph-api; если хотя бы одно звено отсутствует, уверенность не повышают и решение остаётся на повторной проверке.
Граница применимости
Инвентарь собирают по схеме «caller | tenant | assistant owner | auth event | run id | outcome». Для каждой реплики отдельно отмечают loaded version, digest артефакта, способ resolution зависимости, owner и доступность функции. Lockfile, image tag и панель обновления являются указателями, а не доказательством работающего кода. Подтверждённая remediation-опора: обновить langgraph-api до 0.10.0 или новее и унифицировать policy для read, cron и run creation. В случае, когда версия видна только в файле сборки или не удалось связать process с артефактом, итог остаётся blocked. В журнал не переносят hostname, IP, usernames, cookies, токены, полные environment, пользовательские объекты и содержимое базы. Такая дисциплина отличает not affected by reachability от простого отсутствия жалоб.
Минимальный изолированный стенд
Стенд должен быть одноразовым, без внешних пользователей и с жёстким лимитом времени, памяти, файлов или событий. Безопасный regression-класс для этой темы: в тестовом tenant создать двух пользователей и по одному пустому assistant; каждый запускает свой объект, затем user A запрашивает run для assistant B без инструментов и данных. Первым шагом выполняют положительный контроль, затем меняют ровно один параметр для отрицательного, на следующем шаге чего повторяют нормальную операцию. Expected outcome записывается до запуска; observed outcome — на следующем шаге, без подгонки. Никакой итог теста здесь не заявляется как уже полученный: это процедура, которую ответственному инженеру ещё предстоит выполнить в своей среде. Для cleanup заранее задают удаление synthetic fixtures и возврат исходной конфигурации изолированный контура.
Наблюдения до и после
До обновления удерживают baseline по тем же полям: caller | tenant | assistant owner | auth event | run id | outcome. После установки исправления повторяют идентичный harness и сравнивают не только ответ проблемной ветви, но и обычную функцию, resource ceiling и следующую операцию. Целевой признак сформулирован конкретно: свой run создаётся, чужой не принят тем же policy decision, audit содержит assistant identity и tenant. Timeout сам по себе двусмыслен — он может означать защитный отказ, сломанный маршрут или потерю наблюдаемости. Отсюда следует: required evidence включает status, очищенный reason, digest, счётчик перезапусков и отсутствие нежелательного изменения состояния. В случае, когда положительный контроль перестал работать, отрицательный ответ нельзя объявить защитой.
Развилка вердикта
Verdict passed допустим только при одновременном выполнении четырёх условий: runtime входит в исправленную область, контрольный сценарий успешен, ограниченный отрицательный сценарий получает ожидаемый ранний отказ, а состояние на следующем шаге опыта совпадает с baseline. Failed означает нарушение хотя бы одного проверяемого инварианта. Blocked выбирают, если неизвестны loaded version, reachability или наблюдаемость. Специальная строка решения для langgraph-api — «caller | tenant | assistant owner | auth event | run id | outcome». Стоп-линия также предметна: нужен реальный thread, пользовательские сообщения, платный model call или расширение прав тестовой роли. При её достижении опыт прекращают, удерживают только обезличенный error-class и не расширяют вход ради наглядности.
Канарейка и возврат
Изменение выпускают одной канарейкой: обновить langgraph-api до 0.10.0 или новее и унифицировать policy для read, cron и run creation. Рядом должны лежать прежний digest, совместимый snapshot и проверенная команда возврата. Code rollback и state rollback отмечают раздельно, поскольку старый бинарник не обязательно понимает уже изменённое состояние. На канарейке вновь выполняют положительный и отрицательный контроли, затем выдерживают малое окно наблюдения. Распространение останавливают при росте ошибок, ресурсов, restart counter, при изменении штатного итога или утрате telemetry. Исчезновение исходного симптома без сохранности нормальной функции не является основанием для общего зелёного verdict.
Пакет владельцу
Компактный очищенный пакет содержит GHSA-jfj5-wrj9-63x4, URL advisory и первичной release/registry-страницы, версии до и на следующем шаге, SHA-256 или image digest, timestamp Europe/Moscow, expected/observed и строку «caller | tenant | assistant owner | auth event | run id | outcome». Добавляют длительность малого окна, статус snapshot и один обезличенный reason. Удаляют абсолютные домашние пути, адреса, идентификаторы аккаунтов, ключи, session values, сырой payload и пользовательские документы. Источники подтверждают класс дефекта и существование защищённой поставки 0.10.0, но не заменяют локальную проверку, не доказывают затронутость конкретной установки и ничего не обещают о будущей индексации или позициях страницы.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, версии и ссылки перепроверены. Реальные пользовательские данные, активные опасные payload и вымышленные результаты тестов не использовались.
Источники и проверка
- GitHub Advisory Database: GHSA-jfj5-wrj9-63x4 проверено 2026-08-30
- PyPI: langgraph-api 0.10.0 проверено 2026-08-30
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.