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

Решения

Как модуль Безопасности группирует обнаруженные проблемы в решения, уже обработанные CoRoid, в три категории, и как вы проверяете ответы и применяете их по категориям.

Модуль Безопасности может найти многое: один уязвимый пакет, о котором сообщают шесть уведомлений, секретный сканер, обнаруживший тот же пример пароля в пятидесяти файлах документации. Вы не принимаете решения по каждой проблеме по отдельности. Модуль Безопасности группирует их в решения: каждая открытая проблема, для которой есть готовое решение. CoRoid уже дал ответ на каждую из них. Вы проверяете эти ответы, меняете неверные и применяете их по категориям.

Раздел «Решения» — это вкладка модуля Безопасности между Обзором и Проекты. Его счетчик показывает количество срочных решений.

Что составляет одно решение

  • Пакет, во всех ваших Проектах: «hono → 4.13.16 в 2 проектах» — это одно решение, независимо от количества уведомлений об обновлении.
  • Папка с тестовым кодом или инструментами: всё, что находится под e2e/ или в разделе кодировочного инструмента .opencode/, независимо от типа обнаруженной проблемы и уровня её серьезности, указанного сканером.
  • Примеры одного типа: учетные данные, специально записанные в документации, слова в каталогах переводов, начальные данные, .example файлы.
  • Правило в одной службе: «Нарушение контроля доступа в apps/api-admin». Утверждения, которые не подтверждены независимой проверкой, являются отдельным решением, отличным от подтвержденных проблем.
  • Правило о секретах в коде Проекта.

Проблема, исправление которой уже начато, не входит в решения. Она указывается в категориях («CoRoid уже работает над 2 дополнительными») и появляется снова только при неудаче исправления. Проблема, скрытая исключением, также не входит в решения.

Три категории

  • Срочные: проблемы, эксплуатируемые везде, критические или просроченные в вашей версии для развертывания. Сначала займитесь ими.
  • Следует сделать: проблемы в вашей версии для развертывания, но не просроченные. На их решение можно потратить несколько дней.
  • Очистка: тестовый код, инструменты, примеры и низкоуровневые утверждения, независимо от их серьезности. В основном это шум, который можно обработать массово.

В каждой категории указано количество оставшихся решений, примерное время их выполнения и индикатор уже обработанных сегодня решений.

Ответ CoRoid

Каждое решение содержит ответ CoRoid, с пометками Точно или Вероятно и одной строкой объяснения. Откройте решение, чтобы прочитать полное обоснование, местоположение связанных проблем и все ответы с описанием действий.

Если только человек может определить, например, является ли учетное данное в вашем коде реальным, решение не имеет ответа и отображает сообщение Требует вашего участия. Функция применения игнорирует его до вашего выбора.

Оценка по коду

Решение по учетному данному или кодовой проблеме открывается разделом Где это находится: каждое местоположение с окружающими строками так, как они были в коммите, где сканер обнаружил проблему, с отмеченной строкой, а для репозитория GitHub Открыть в GitHub, что открывает эту строку в соответствующем коммите. Для принятия решения вам не нужен редактор или выгрузка кода.

Само учетное данное никогда не покидает копию вашего репозитория в CoRoid. Все значения, похожие на учетные данные в отображаемых строках, скрыты, а модуль Безопасности сообщает только их длину и вид:

  • распространенное стандартное слово, такое, какое используется в локальной среде установки (changeme, postgres);
  • случайный набор символов, как обычно бывает с настоящим ключом или паролем;
  • читаемый текст, например, парольная фраза.

В большинстве случаев видимая информация остается: переменная, в которую присвоено значение, хост в строке подключения, является ли строка комментарием, и ссылки, такие как ${DB_PASSWORD} , которые не содержат значения.

Если файл был удален после обнаружения учетных данных сканером, в соответствующем месте будет указано об этом. Удаление файла не удаляет учетные данные из истории репозитория: любой, кто имеет доступ к репозиторию, все равно сможет найти их в предыдущих коммитах. Если данные реальные, смените их.

ОтветЧто это делает
Начать исправлениеДля каждого Проекта создается задача по обработке проблем данного решения. Исправление возвращается в виде pull request.
Проверить, затем исправить реальные проблемыТа же задача для утверждений: сначала проверяет каждое утверждение, исправляет реальные и оставляет примечание о остальных.
Открыть обновлениеОткрывает обновление как задачу на исправление, по одному pull request на Проект.
Игнорировать папкуПроблемы в этой папке перестают учитываться, как сейчас, так и в последующих сканированиях. Эту настройку можно отменить.
Это не секретЗакрывает обнаруженные проблемы, а сканер секретов учится на вашем ответе.
Не проблема...Отмечает их как ложноположительные результаты, сохраняя вашу причину в их истории.
Принять на 90 днейСкрывает их на 90 дней или до тех пор, пока уровень их серьёзности не возрастёт.
Да, сменить егоФормирует чек-лист по смене. Проблема закрывается после подтверждения того, что старое значение больше не работает.
Да, уже смененоЗакрывает их после вашего подтверждения.
Передать администратору...Перемещает его в список другого Владельца или администратора с вашей пометкой.
Пропустить на сегодняЗавтра он вернётся на то же место.

Если вы измените ответ, система Безопасность предложит тот же ответ для похожих решений: «Ещё одно решение такого типа... Тот же ответ».

Применение пачки

Применить Применяет все готовые ответы из пачки. Сообщение указывает, какая работа началась (она отображается в Factory), и предлагает Отменить. Отвечено сегодня показывает ваши ответы. Вы можете отозвать те, для которых это допустимо: исключения, вердикты, пропуски и передачи. Начатая работа останавливается в Factory, а не здесь.

Когда задача «Срочно» выполнена, система Безопасность сообщает, сколько решений осталось и сколько из них просрочены по сроку исправления, затем предлагает Остановиться на сегодня или Продолжить работу.

Клавиатура тоже работает: стрелки ↑ и ↓ перемещают между решениями, Enter открывает одно, цифры 1–9 выбирают ответ, а ⌘ Enter применяет его.

В Factory

В Factory Требует вашего участия отображает одну строку Безопасности, пока решение срочное: «5 срочных решений · около 2 минут · 32 в общей сложности». Начать открывает Раздел решений. Решение, которое не может ждать, имеет собственную строку: взломанный пакет, подтверждённая критическая проблема или учётные данные, которые человек подтвердил как реальные в вашей среде развертывания.

Как только не остаётся срочных задач, строка исчезает из раздела «Требует вашего участия», и появляется строка с количеством решений, которые можно оставить до следующей сессии.

Кто отвечает

Владельцы и администраторы отвечают на решения. Участники читают их и прилагаемые доказательства. Инструменты MCP и Чат CoRoid отображают те же решения (list_security_needs). См. Безопасность через MCP и Чат.