Документация

Безопасность через MCP и чат

Просматривайте Результаты и принимайте по ним решения в Чате или через свой собственный помощник, соблюдая правила портала, а также узнайте, почему некоторые действия всегда требуют вашего участия.

Вы можете просматривать Результаты по Безопасности и принимать по ним решения в чат-помощнике или через свой собственный помощник. CoRoid в качестве сервера MCP: Claude Code, Codex, Cursor или другой клиент MCP. Эти инструменты следуют тем же правилам, что и портал, поэтому дают одинаковые ответы и отклоняют те же запросы.

Чтение

У Безопасности есть собственные области видимости, поэтому подключение, созданное для других задач, не увидит Результаты. Для работы этих инструментов требуется роль Рецензента и mcp.security.read. Ни один из них не нуждается в утверждении. Они следуют собственным правилам Безопасности CoRoid: вы видите проекты, доступные в портале. Подключение, ограниченное несколькими проектами, должно указать один из них или соответствующий результат.

ИнструментЧто он отвечает
get_security_overviewПо проекту: открытые Результаты с указанием степени серьёзности, просроченные сроки устранения, задачи, которые никто не подтвердил, тестовый код и количество пунктов, требующих вашего участия.
list_security_findingsРезультаты по проекту, типу, степени серьёзности и состоянию, сначала те, что были обнаружены первыми, затем — по степени серьёзности; needsYou отбирает только те, что требуют вашего участия.
list_security_needsРешения, ожидающие утверждения человеком — сначала самые срочные, каждое со своим ответом от CoRoid и ссылкой для открытия: тот же список, что и в разделе «Безопасность» → «Решения»
get_security_findingОдин результат: его местоположение, подтверждён ли он, когда он должен быть устранён и какова работа по его исправлению. Никогда — стоимость секрета.
get_security_settingsКаждая мера защиты проекта применяется в соответствии с правилами: отключена, в режиме наблюдения, принудительная или недоступна, с указанием причины и параметров, выбранных для проекта.
list_security_runsЗапуски Безопасности, самые новые первыми, как указано в журнале запусков: выполняются, ожидают, завершены, завершились ошибкой или заменены, с объяснением причины сбоя.
get_attack_surfaceТочки входа каждого проекта и количество пунктов, ожидающих проверки; для одного проекта — все точки входа с описанием кода и решениями команды, предложения по развертыванию и результаты проверки pull request.
get_threat_modelВерсия модели угроз каждого проекта и количество пунктов, ожидающих рецензирования; для одного проекта — сама модель, предложение, находящееся на рассмотрении, и последние версии.
list_security_packagesАктуальные списки зависимостей каждого проекта с указанием числа установленных пакетов и уязвимых из них; для одного проекта — страница с пакетами, сначала уязвимые.

Каждый результат содержит ссылку на свою страницу в CoRoid.

Действия с результатами

Эти инструменты работают с результатами. Для этого им требуются mcp.security.write и владелец или администратор, как и в портале.

ИнструментЧто он делаетУтверждение
start_security_fixИсправление, как в портале: устранение уязвимой зависимости, задача с регрессионным тестом для найденной ошибки в коде, чек-лист ротации для скомпрометированного учётных данных. Вторая команда Fix отвечает на уже созданную задачу.Нет
run_security_scanПросканировать один проект сейчас: все активные элементы, зависимости, историю секретов, поверхность атаки, аудит (где он активен) или сохранённые доказательства.Нет
confirm_real_secretПодтвердить, что скомпрометированные учётные данные действительно существуют. Они остаются открытыми до тех пор, пока кто-то не подтвердит их ротацию.Нет
revoke_security_exceptionЗавершить исключение: результат снова станет открытым.Нет
dismiss_security_findingОтметить результат как «Не проблема» с указанием причины.Всегда
add_security_exceptionПринять риск, связанный с результатом, до определённой даты, с указанием причины.Всегда
attest_secret_rotatedПодтвердить, что скомпрометированные учётные данные были заменены или аннулированы, что закрывает результат. CoRoid никогда не проверяет найденные учётные данные.Всегда

Действия с поверхностью атаки и моделью угроз

Для этого также требуются mcp.security.write и владелец или администратор. Там, где одна настройка в портале одновременно усиливает и ослабляет контроль, существуют два инструмента: тот, что усиливает, отклоняет изменение, которое ослабляет контроль, поэтому такое изменение всегда требует вашего участия.

ИнструментЧто он делаетУтверждение
raise_entry_point_exposureСделать точки входа более доступными, зафиксировать их для аудита или вернуть их в область видимости.Нет
lower_entry_point_exposureСделать точки входа менее доступными, снять фиксацию или исключить их из области видимости с указанием причины.Всегда
refresh_threat_modelПовторно проанализировать код проекта; полученные результаты будут представлены как предложения.Нет
add_threat_model_entriesДобавить элементы в модель угроз.Нет
accept_threat_model_proposalПринять предложения, полученные после повторного анализа кода.Нет
update_threat_model_entriesИзменить заголовок или детали элемента.Всегда
remove_threat_model_entriesУдалить элементы из модели угроз.Всегда
dismiss_threat_model_proposalОтклонить предложения, полученные после повторного анализа кода.Всегда
keep_security_proofСохранить доказательство, воспроизводящее результат, в качестве регрессионного теста.Нет

Изменение параметров защиты

Настройки защиты для конкретного проекта или параметры по умолчанию организации настраиваются в двух одинаковых инструментах: tighten_security_protection усиливает параметры защиты и отклоняет любые изменения, ослабляющие их, а relax_security_protection ослабляет их, либо заставляет проект снова следовать параметрам по умолчанию организации, при этом всегда требуется подтверждение человека. Изменение считается ослаблением, если уровень обнаружения или принудительного применения снижается, порог серьезности увеличивается, количество открываемых исправляющих запросов уменьшается, аудит отключается или выполняется реже, сканирование секретов охватывает меньше данных, сеть песочницы расширяется или разрешает больше хостов, либо точка входа типа «не задано» больше не считается доступной из интернета. Параметр «Собственная команда сканирования» задается в разделе «Контроль качества».

Контакты и раскрытие информации

Контакты по вопросам безопасности проекта обладают полномочиями на раскрытие информации наравне с владельцами и администраторами: они видят исправления CoRoid, сохраненные в закрытом виде для нераскрытых уязвимостей, могут публиковать или удалять их, составлять черновики рекомендаций по безопасности GitHub и фиксировать отчеты для разработчиков зависимостей. Через MCP и Чат эти действия выполняются владельцами и администраторами, при этом всегда требуется подтверждение человека: контакт может раскрыть информацию об уязвимости, и такое раскрытие уже нельзя отменить.

ИнструментЧто он делаетПодтверждение
list_security_contactsКонтакты по вопросам безопасности проекта и кто может ими бытьНет
get_security_disclosureЗакрытые исправления уязвимости (размер и состояние, но не их содержимое), рекомендация GitHub и отчеты, отправленные разработчикам, — всё это предоставляется обладателям полномочий на раскрытие информацииНет
add_security_contactНазначить участника проекта контактом по вопросам безопасностиВсегда
remove_security_contactУдалить контакт по вопросам безопасностиВсегда
publish_private_fixОпубликовать сохраненное исправление: уязвимость становится раскрытой, и для задачи открывается раздел pull requestВсегда
discard_private_fixУдалить сохраненное исправлениеВсегда
draft_github_security_advisoryСоставить черновик рекомендации по безопасности GitHub в репозитории, доступный для просмотра разработчикамВсегда
record_maintainer_reportЗафиксировать, куда вы сообщили о уязвимости разработчикам зависимостей. CoRoid ничего не отправляет.Всегда

Почему некоторые действия требуют подтверждения человека

Это не проблема: принятый риск и ротация учетных данных удаляют уязвимость из списка открытых без исправления; менее уязвимая точка входа и меньшая модель угроз исключают элементы из области аудита. Помощник не должен иметь возможность делать это самостоятельно, поэтому эти инструменты всегда требуют подтверждения человека, независимо от настроек соединения:

  • Из клиента MCP запрос ожидает подтверждения от владельца или администратора Настройки → Подключения → CoRoid MCP сервер → Согласования, и им приходит уведомление. Запрос истекает через 10 минут.
  • В Чате помощник запрашивает у вас подтверждение в чате перед выполнением действия.

В подтверждении простыми словами указывается, что произойдет, на основе записи CoRoid об уязвимости: «Отметить нарушение контроля доступа в src/routes/admin.ts:76 (Магазин) «Не является проблемой», после чего приводится причина в кавычках. Текст вокруг причины берется из CoRoid, а не от помощника, и значение учетных данных никогда не отображается: CoRoid его не сохраняет.