Защитная памятка по mcp-shell и GHSA-f5pj-2738-996m: область версий, runtime-инвентарь, обратимый тест, критерии решения, стоп-линия, канарейка, возврат и очищенный журнал без опасного payload.
Какой факт подтверждён
Сначала отделите подтверждённый факт advisory от предположения о своей установке и только затем планируйте стенд. Официальная запись GHSA-f5pj-2738-996m подтверждает для mcp-shell: разные пути старта создавали разную защиту, а разрешение интерпретатора превращало узкий список команд в широкую возможность. Подтверждённая область — mcp-shell до 0.6.0, где запуск bare binary мог оставить security mode выключенным, а shell interpreter мог попасть в небезопасный allowlist. Это описание класса дефекта и границы исправления, но не свидетельство того, что определённый сервер, контейнер или рабочее место действительно использует затронутый маршрут. До любого изменения отметьте статус как unknown, affected, not affected by reachability либо blocked и запишите основание; отсутствие жалоб и зелёный health сами по себе ничего не доказывают. Контрольная группа редакционного шаблона: 3. Проверяемая цепочка именно для mcp-shell записывается отдельно: исходный факт — разные пути старта создавали разную защиту, а разрешение интерпретатора превращало узкий список команд в широкую возможность; практическое исправление — обновить mcp-shell до 0.6.0 и сделать secure mode одинаковым для bare binary и запуска с config. Если хотя бы одно звено взято не из фактической поставки, применимость остаётся неизвестной, даже когда номер пакета выглядит новым.
Карта применимости
Для mcp-shell соберите одну строку «startup path | secure mode | command class | allowlist decision | child process» из фактического runtime. Нужны версия реально загруженного компонента, digest артефакта, способ dependency resolution, включённая функция и владелец изменения. Manifest, lockfile и container tag полезны как указатели, но могут расходиться с работающим процессом. Не переносите в отчёт hostname, IP, usernames, tokens, cookies, полные environment, пользовательские документы или содержимое базы. Если runtime identity либо достижимость функции не подтверждены, не повышайте уверенность: честный итог — blocked до безопасного inventory. Уникальные поля этой инвентаризации — «startup path | secure mode | command class | allowlist decision | child process». Их заполняют одной строкой на runtime, не смешивая несколько реплик в среднее значение. Граница версии сформулирована так: mcp-shell до 0.6.0, где запуск bare binary мог оставить security mode выключенным, а shell interpreter мог попасть в небезопасный allowlist. Это позволяет отличить неподтверждённую установку от доказанно недостижимой функции.
Контроль до обновления
Перед remediation сохраните восстановимый snapshot конфигурации и тестовых данных, прежний SHA-256 или image digest, resource ceiling и критерий остановки. контролируемый regression-прогон: запустить временный экземпляр как bare binary и с config: оба должны быть fail-closed; явно разрешённый безвредный /bin/echo проходит, запрещённый interpreter отклоняется без открытия shell. Он проводится только на synthetic data и в отдельном namespace или процессе. Сначала запишите ожидаемое policy-ответ и baseline, затем одинаковым способом проверьте исправленную сборку. Нельзя подменять наблюдение догадкой: timeout может означать crash, неверный маршрут или потерю telemetry, а HTTP status не показывает, было ли уже выполнено опасное действие внутри. Контрольный объект для mcp-shell не содержит пользовательского состояния. Его прогон: запустить временный экземпляр как bare binary и с config: оба должны быть fail-closed; явно разрешённый безвредный /bin/echo проходит, запрещённый interpreter отклоняется без открытия shell. Эксперимент не начинают, если уже на этапе подготовки верно условие остановки: тест вызывает настоящий shell, рабочий MCP-клиент или команду, меняющую файлы. Такая проверка ценнее рискованной демонстрации, потому что её можно повторить после отката.
Два безопасных сценария
Положительный прогон обязан сохранить штатную функцию: оба пути имеют одинаковую политику, разрешённая команда ограничена, interpreter не запускается. Отрицательный прогон отличается ровно одним измерением, указанным в матрице, и должен завершиться ранним ограниченным отказом. Не расширяйте вход после первого понятного решения и не добивайтесь аварии ради наглядности. Для пары опытов заранее задайте лимит времени, памяти, числа объектов или сетевых событий и один cleanup. Если положительный контроль не проходит, отрицательный итог нельзя объявлять защитой: стенд может быть просто сломан или обращаться не к тому runtime. Контраст двух сценариев имеет один ожидаемый рабочий исход: оба пути имеют одинаковую политику, разрешённая команда ограничена, interpreter не запускается. Отрицательная ветвь отвечает только на подтверждённую проблему — разные пути старта создавали разную защиту, а разрешение интерпретатора превращало узкий список команд в широкую возможность. Остальные параметры, включая артефакт, конфигурацию, лимит и набор synthetic data, сохраняют одинаковыми, чтобы не спутать защитное policy-ответ с изменением стенда.
Как читать результат
Passed означает одновременно: фактическая версия входит в исправленную область, положительный контроль работает, отрицательный получает ожидаемое раннее policy-ответ, status остаётся целым, а следующий рабочий запрос успешен. Failed — нарушение хотя бы одного из этих условий. Blocked — отсутствует наблюдаемость, identity runtime или контролируемый стенд. Для этой темы специальная развилка такова: Нужно сверять два entrypoint отдельно. Исправленная конфигурация не доказывает безопасность прямого запуска бинарника и наоборот. Сохраните observed decision независимо от ожидания; фраза «похоже исправлено» не годится как итог. Для чтения результата используйте специфическую развилку: Нужно сверять два entrypoint отдельно. Исправленная конфигурация не доказывает безопасность прямого запуска бинарника и наоборот. Её сопоставляют со строкой «startup path | secure mode | command class | allowlist decision | child process», а не с общим впечатлением оператора. Если наблюдение нельзя выразить этими полями, материала пока недостаточно для passed или not affected.
Изменение и путь назад
Remediation для этой записи: обновить mcp-shell до 0.6.0 и сделать secure mode одинаковым для bare binary и запуска с config. Делайте вмешательство одной канарейкой, повторите обе сверки тем же harness и сравните digest, loaded version, restart counter, resource budget и первый релевантный error-class. Backup считается пригодным только вместе с проверенной командой восстановления и пониманием совместимости состояния. Возврат бинарника не всегда возвращает формат данных, поэтому state rollback и code rollback отмечают отдельно. Если после обновления изменяется штатное поведение или наблюдаемость, остановите распространение, верните канарейку и не публикуйте общий зелёный вердикт. Канарейка mcp-shell считается завершённой лишь после шага «обновить mcp-shell до 0.6.0 и сделать secure mode одинаковым для bare binary и запуска с config» и повторного подтверждения: оба пути имеют одинаковую политику, разрешённая команда ограничена, interpreter не запускается. Рядом сохраняют прежний digest и совместимый snapshot. Любое расхождение штатного контроля превращает rollout в paused независимо от того, исчез ли исходный симптом.
Красные флаги опыта
Жёсткий стоп-критерий: тест вызывает настоящий shell, рабочий MCP-клиент или команду, меняющую файлы. Также остановитесь при появлении настоящих secrets, персональных данных, внешнего неподконтрольного адреса, широких прав, необратимой миграции, растущего resource budget или необходимости раскрыть активную последовательность. Не используйте публичный форум как доказательство причины, затронутости или массовости; он лишь напомнил проверить backup и rollback. Один успешный запрос, отсутствие публичного кода атаки, статус service active и тишина журнала остаются ложнозелёными сигналами без специфической матрицы. Для данного компонента аварийная граница сформулирована буквально: тест вызывает настоящий shell, рабочий MCP-клиент или команду, меняющую файлы. Не заменяйте её более широким опытом. Допустимый прогон остаётся узким: запустить временный экземпляр как bare binary и с config: оба должны быть fail-closed; явно разрешённый безвредный /bin/echo проходит, запрещённый interpreter отклоняется без открытия shell. При первом превышении лимита фиксируют очищенный error-class и возвращают стенд в исходное status.
Очищенный журнал решения
Минимальный пакет владельцу: GHSA-f5pj-2738-996m, фактическая версия до и после, URL двух первичных источников, digest артефакта, timestamp Europe/Moscow, expected/observed decision и очищенная строка «startup path | secure mode | command class | allowlist decision | child process». Добавьте продолжительность малого окна, статус snapshot/rollback и один обезличенный error-class. Удалите абсолютные домашние пути, адреса, идентификаторы аккаунтов, session values, содержимое объектов и сырой payload. Advisory подтверждает технический факт и исправленную версию, но не итог вашего опыта; поэтому не выдумывайте тест, которого не проводили, и не обещайте индексацию или позиции статьи. Строка завершения для GHSA-f5pj-2738-996m обязана связать «startup path | secure mode | command class | allowlist decision | child process» с ожидаемым штатным признаком: оба пути имеют одинаковую политику, разрешённая команда ограничена, interpreter не запускается. Так другой инженер сможет проверить policy-ответ без доступа к секретам и сырому входу. Если ссылка, версия или digest позднее меняются, запись переводят в needs re-verification, а не молча считают актуальной.
Материал подготовлен редакцией VOne с помощью ИИ по открытым официальным и первичным источникам; факты, версии и ссылки перепроверены. Реальные пользовательские данные, активные опасные payload и вымышленные результаты тестов не использовались.
Источники и проверка
- GitHub Advisory Database: GHSA-f5pj-2738-996m проверено 2026-08-30
- Релиз mcp-shell v0.6.0 проверено 2026-08-30
Информация актуальна на дату публикации. Правила сервисов, приложений и сетей могут меняться.