Защитная диагностика Fastify trustProxy hop-count по ghsa-3m5p-2c4r-xxw2: применимость, обратимый локальный control, измеримый verdict, stop-rule и пакет данных для владельца системы.
Короткий ответ — Fastify trustProxy: определение клиентского IP по цепочке
Задача страницы — проверить, что Fastify при hop-count trustProxy одинаково определяет client IP для реальной и синтетической proxy-цепочки. Advisory ghsa-3m5p-2c4r-xxw2 служит свежим inventory-сигналом, но не доказывает состояние конкретной установки. Зафиксируйте фактически загруженный Fastify trustProxy hop-count, lock-файл или image digest и границу «fastify: introduced 5.8.3, fixed 5.12.1». Пользовательская боль здесь одна: подставленный X-Forwarded-For может изменить адрес, к которому применяется rate limit или access policy. Итогом должен стать артефакт «peer / forwarded chain length / selected IP / trust reason / policy result», чтобы другой инженер повторил решение без production-данных, внешнего воздействия и догадок.
Граница применимости для Fastify trustProxy hop-count
Разберите путь решения как «peer socket → forwarded chain → trusted-hop parser → client IP → policy input». Для каждого перехода укажите владельца значения, тип входа, допустимое состояние и запрещённый side effect. Проверяемая инварианта: доверие определяется от фактического peer к клиенту, а добавленный слева адрес не меняет policy identity. NOT_APPLICABLE возможен только при доказанном отсутствии компонента или недостижимости указанной ветки; неизвестный digest, effective config или способ вызова дают UNKNOWN. Номер исправленного релиза без runtime readback не превращает результат в PASS.
Почему проверки версии недостаточно
Lock-файл, SBOM, container digest и вывод package manager отвечают на разные вопросы. Сведите их в одну строку provenance и сопоставьте с advisory-границей «fastify: introduced 5.8.3, fixed 5.12.1». Затем докажите effective путь «peer socket → forwarded chain → trusted-hop parser → client IP → policy input»: vendored копия, optional dependency, отдельный worker или отключённый adapter могут изменить применимость. Фиксируйте AFFECTED_PATH, PATCHED_PATH, COMPONENT_ABSENT либо PROVENANCE_UNKNOWN. Отсутствие инцидента и успешный health-check не подтверждают инварианту «доверие определяется от фактического peer к клиенту, а добавленный слева адрес не меняет policy identity».
Безопасный обратимый локальный control
Работайте только в disposable fixture: через inject и фиксированный peer прогнать таблицу цепочек одинаковой длины, записывая только request.ip и reason code. Сеть, subprocess, production database, реальные bucket, очереди, почту, токены и пользовательские файлы замените fake, spy или in-memory адаптерами. До запуска сохраните baseline hash, нулевые counters, лимит времени, памяти и числа операций. Используйте короткие синтетические маркеры без эксплуатационного payload. После каждой строки восстанавливайте fixture и убеждайтесь, что benign control начинается с того же baseline.
Матрица наблюдений
Сначала benign control доказывает достижение целевой функции. Затем boundary-case меняет ровно один признак, связанный с болью «подставленный X-Forwarded-For может изменить адрес, к которому применяется rate limit или access policy». Записывайте «peer / forwarded chain length / selected IP / trust reason / policy result», reason code, duration, counters до и после и digest fixture. Основная инварианта остаётся: доверие определяется от фактического peer к клиенту, а добавленный слева адрес не меняет policy identity. Если control не достигает ветки, recorder пропустил side effect или точка наблюдения двусмысленна, ставьте UNKNOWN. Нельзя усиливать вход ради определённого ответа: безопасная воспроизводимость важнее красивого PASS.
PASS, FAIL, UNKNOWN и критерий остановки
PASS требует подтверждённого provenance, успешного benign control, соблюдения инварианты «доверие определяется от фактического peer к клиенту, а добавленный слева адрес не меняет policy identity», нулевых запрещённых side effects и cleanup proof. FAIL — тот же подтверждённый путь плюс наблюдаемое нарушение policy. UNKNOWN означает отсутствие digest, effective config, recorder или возможности восстановить fixture. Немедленная красная линия: неподтверждённый левый адрес стал policy identity при неизменном peer. При ней прекратите тест, сохраните только минимальные метаданные и не повторяйте boundary-case на большем масштабе.
Восстановление и regression check
Удалите disposable state, верните adapters к baseline и сравните hashes, counters, память и открытые ресурсы. Неожиданный I/O, сетевой вызов, процесс, новая строка БД или оставшийся файл блокирует PASS. После обновления повторите тот же fixture без изменения входов и лимитов; сравните «peer / forwarded chain length / selected IP / trust reason / policy result». Так видно, изменился ли защищаемый переход «peer socket → forwarded chain → trusted-hop parser → client IP → policy input», а не окружение, объём данных или наблюдатель.
Почему intent самостоятельный и что передать владельцу
Отделяет семантику количества доверенных переходов от общей настройки reverse proxy и даёт матрицу выбранного IP. Поэтому материал отвечает на самостоятельный запрос «проверить, что Fastify при hop-count trustProxy одинаково определяет client IP для реальной и синтетической proxy-цепочки» и не является механической заменой бренда, ОС или устройства. Передайте владельцу ghsa-3m5p-2c4r-xxw2, component digest, effective version/config, границу «fastify: introduced 5.8.3, fixed 5.12.1», схему «peer socket → forwarded chain → trusted-hop parser → client IP → policy input», control/boundary rows, артефакт «peer / forwarded chain length / selected IP / trust reason / policy result», verdict, stop reason и cleanup proof. Advisory опубликована 2026-09-02 и обновлена 2026-09-02; даты подтверждают свежесть источника, но не популярность запроса, факт эксплуатации или применимость к конкретному deployment.
Материал подготовлен редакцией VOne с помощью автоматизированного черновика; даты, версии и ссылки сверены по GitHub Advisory Database и первичному upstream-материалу. Текст самостоятельный, не копирует источники, не содержит эксплуатационных последовательностей и предназначен для безопасной локальной проверки.
Источники и проверка
- GitHub Advisory Database — ghsa-3m5p-2c4r-xxw2 проверено 2026-09-03
- Первичный upstream advisory — Fastify trustProxy hop-count проверено 2026-09-03
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.