Защитный разбор oapi-codegen и ghsa-rjwr-m7qx-3fjr: применимость, безопасный test boundary «экранирование OpenAPI server description перед включением в generated Go comment», измеримый результат, stop-rule и пакет поддержки.
Определите, относится ли сигнал к oapi-codegen
Сначала исследуется не severity, а граница «экранирование OpenAPI server description перед включением в generated Go comment». Запишите версию живого процесса, build digest, путь загруженного компонента, способ установки и включённую функцию. Advisory перечисляет «github.com/oapi-codegen/oapi-codegen/v2 <= 2.7.0 → fixed 2.7.1», однако зависимость в manifest не равна доказанной runtime-версии. Отдельно установите, достижим ли путь в вашей конфигурации и какой субъект его вызывает. Если provenance или reachability не подтверждены, оставьте статус unknown. Это честнее, чем переносить оценку advisory на конкретное развёртывание без измерения.
Фактическая рамка GHSA-rjwr-m7qx-3fjr
Reviewed record опубликован 2026-07-17, обновлён 2026-07-17 и формулирует проблему как «oapi-codegen: OpenAPI Server Description Escapes Generated Go Comment and Injects Executable Code». Package ranges: «github.com/oapi-codegen/oapi-codegen/v2 <= 2.7.0 → fixed 2.7.1». Репозиторий oapi-codegen/oapi-codegen подтверждает происхождение upstream, но не состояние вашей установки. Даты, affected range и механизм берутся из прямой advisory-страницы. Ни GitHub record, ни форумный лид не доказывают атаку, ущерб, распространённость запроса, индексацию или позицию. Любое такое утверждение потребовало бы отдельной телеметрии и источника.
Отдельная боль и наблюдаемые точки: экранирование OpenAPI server description перед включением в generated Go comment
Узкая пользовательская боль: описание схемы может завершить комментарий и добавить неожиданные конструкции в generated source. Чтобы не спутать её с ошибкой стенда, заранее задайте независимые поля артефакта «сводку schema-digest / generated-digest / parse-ok / declarations / imports / marker-location». Нормальная ветвь обязательна: обычное description создаёт валидный файл с ожидаемым endpoint declaration. Только после неё запускают один граничный case. Marker не должен быть credential, реальным идентификатором или пользовательским содержимым. Такое разделение даёт проверяемое дерево решения и не превращает похожую ошибку, timeout либо неверную роль в подтверждение security-механизма.
Безопасный обратимый опыт
Создайте минимальная OpenAPI schema с marker, newline и comment-delimiter, но без исполняемого payload. Затем нужно сгенерировать код во временный каталог, разобрать Go AST и сравнить declarations с normal schema. Все операции выполняются в локальной или одноразовой среде с пределами wall-time, CPU, памяти, файлов, сокетов и запросов. Ожидаемый защитный результат определён до запуска: marker остаётся комментарием или безопасно экранируется, дополнительных declarations и imports не возникает. Не используйте production secrets, настоящие документы, внутренние адреса, пользовательские логи или публичные цели. После первой граничной точки очистите fixture, повторите normal-control и сравните итоговое состояние с baseline digest.
Правило решения без догадок
Решение хранится как сводку schema-digest / generated-digest / parse-ok / declarations / imports / marker-location. Passed возможен, когда одновременно наблюдается «marker остаётся комментарием или безопасно экранируется, дополнительных declarations и imports не возникает», normal-control успешен и cleanup возвращает baseline. Failed фиксируют лишь после воспроизводимого расхождения с тем же fixture и лимитами. Not-applicable требует доказанной runtime-версии вне range либо документированно выключенного пути. Unknown остаётся при неполном provenance, нестабильном trace или неоднозначной конфигурации. Одного HTTP status, падения процесса или отсутствия события недостаточно для окончательного вывода.
Остановка, обновление и пакет для поддержки
Stop-rule этого опыта: не компилировать результат при появлении лишнего AST declaration. Если runtime входит в affected range, обновление получают из доверенного канала oapi-codegen/oapi-codegen, после чего повторяют ровно тот же fixture с прежними лимитами; новый сценарий не подтверждает исправление старого. В обезличенный пакет включают runtime version, digest, конфигурационную ветвь, expected/observed, измеренные лимиты, timestamps, error class и хэши fixtures. Исключите токены, cookies, IP, внутренние имена, абсолютные пути и содержимое данных. Инструкция не обещает абсолютную защищённость.
Материал подготовлен редакцией VOne с помощью ИИ; даты, диапазоны, прямые ссылки, безопасный опыт и отсутствие рекламных обещаний затем перепроверены по первичным источникам.
Источники и проверка
- GitHub Reviewed Advisory ghsa-rjwr-m7qx-3fjr проверено 2026-08-31
- Upstream-репозиторий oapi-codegen/oapi-codegen проверено 2026-08-31
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.