セキュリティ機能では多数の情報を検出できます。例えば、6件のアドバイザリで報告された脆弱なパッケージや、50件のドキュメントファイルで同じサンプルパスワードが一致したケースなどです。検出結果は個別に処理せず、決定事項として分類されます。決定事項:1つの回答で解決できる未処理の検出結果すべてが該当します。CoRoidが既に各項目への回答を出しており、ユーザーはその回答を確認し、誤りがある場合は修正してから一括で適用します。
「決定事項」タブはセキュリティ機能内にあり、概要タブとプロジェクトタブの間に位置します。このタブに表示される数値は緊急を要する決定事項の件数を示します。
決定事項となる条件
- パッケージ:全プロジェクトにまたがる「hono → 4.13.16が2つのプロジェクトで利用」というケースは1つの決定事項となり、アップグレードで修正されるアドバイザリの件数に関係なく扱われます。
- テストコードやツール関連のフォルダ:以下のパス下にあるすべての内容
e2e/またはコーディングツールの.opencode/、検出種別やスキャナーが判定した重大度に関係なく扱われます。 - 具体的な例:ドキュメントに意図的に記載された認証情報、翻訳カタログ内の文言、シードデータ、
.exampleファイル。 - 1つのサービス内のルール:「apps/api-adminにおけるアクセス制御の不備」。独立した検証で確認されていない主張は、確定した検出結果とは別の決定事項となります。
- プロジェクトコード内の認証情報関連ルール。
すでに修正作業が進行中の検出結果は決定事項には含まれません。該当する項目はグループ内に「CoRoidがさらに2件で対応中」と表示され、修正に失敗した場合にのみ再び表示されます。例外設定で除外された検出結果も決定事項には含まれません。
3つのグループ
- 緊急:どこかで悪用されている、または本番環境で重大な問題を引き起こす、あるいは修正期限を過ぎている項目。最優先で対応します。
- 対応予定:本番環境で問題を引き起こすが修正期限を過ぎていない項目。数日程度なら待機可能です。
- クリーンアップ:テストコード、ツール関連、サンプルデータ、軽微な主張など、重大度に関係なく一括で処理できる項目。ほとんどがノイズであり、一括で回答が出されます。
各グループには残存する決定事項の件数、所要時間、当日に対応した項目の割合が表示されます。
CoRoidの回答
各決定事項にはCoRoidの回答が付随し、確実または可能性が高いとその理由が1行で記載されています。決定事項を開くと全体の理由や関連する検出結果、各回答の内容を確認できます。
コード内の認証情報が実際に使用されているかなど、人間の判断が必要な場合、決定事項には回答がなく「あなたの対応が必要」と表示されます。あなたの対応が必要。ユーザーが選択するまで適用処理はスキップされます。
コードから判断する
認証情報やコード関連の検出結果に関する決定事項は、「所在場所」から確認できます。所在場所:該当する箇所がすべて表示され、スキャン時に参照されたコミット内の周辺行が示され、フラグ付きの行がマークされます。GitHubリポジトリの場合はGitHubで開く、該当コミット内のその行が開かれます。エディターやチェックアウト操作なしで判断できます。
認証情報自体はCoRoidが保持するリポジトリのコピーから外部に流出しません。表示される行内の認証情報らしき値はすべて隠され、セキュリティ機能では長さと形式のみが通知されます:
- 一般的なデフォルト値、ローカル環境で使用されるタイプ(
changeme、postgres); - ランダムに見える形式、実際のキーやパスワードによく見られる形式;
- 読み取り可能なテキスト、パスフレーズなど。
大半の場合は可視化された情報が維持されます。代入先の変数名、接続文字列内のホスト名、コメント行かどうか、および${DB_PASSWORD}といった値を持たない参照先。
スキャン後にファイルが削除されても、その箇所は正しく表示されます。ファイルを削除してもリポジトリの履歴から認証情報が消去されるわけではなく、リポジトリを読み取れるユーザーは以前のコミットでそれを確認できます。実際に使用されている場合は即座に更新してください。
| 回答 | 実行内容 |
|---|---|
| 修正を開始 | 各プロジェクトの決定事項に関連する検出結果に対して1つのタスクが作成されます。修正後の結果はpull requestとして返却されます。 |
| 確認後、実際の問題を修正 | 主張に関しても同様のタスクが実行され、まず各主張を確認し、実際の問題を修正した上で残りの主張には注記を付けます。 |
| アップグレードを開く | アップグレード作業を修正対象として開き、プロジェクトごとに1つのpull requestが生成されます。 |
| フォルダを無視 | 該当フォルダ下の検出結果は現在および今後のスキャンでカウントされなくなります。この設定は取り消し可能です。 |
| 秘密ではありません | 該当する指摘を閉じ、シークレットスキャンはあなたの回答から学習します。 |
| 問題ありません… | 誤検知として閉じ、その理由を履歴に記録します。 |
| 90日間承認する | 90日間、または重大度が上がるまで非表示にします。 |
| はい、ローテーションを行う | ローテーションチェックリストを作成します。古い値がもはや有効でないことを確認すると、指摘が閉じます。 |
| はい、すでにローテーション済み | あなたの確認をもって閉じます。 |
| 管理者に引き継ぐ… | あなたのコメントとともに、別のオーナーまたは管理者のリストに移動させます。 |
| 本日はスキップ | 明日、同じ場所に再び表示されます。 |
回答を変更すると、セキュリティ機能は同様の判断に対して同じ回答を提示します。 例:「このような判断がさらに1件…同じ回答」。
一括適用
適用準備が整ったすべての回答を一括で適用します。どの作業が開始されたかを示すメッセージが表示され(ファクトリーに反映)、取り消し。本日回答済みあなたの回答が一覧表示されます。記録上許可されているものについては取り消すことができます:例外、判定結果、スキップ、引き継ぎです。開始された作業はファクトリーで停止し、ここでは停止しません。
緊急事態が解決されると、セキュリティ機能は残りの判断数と修正期限を過ぎた判断数を通知し、以下を提案します。本日は停止または続行。
キーボードでも操作可能です:↑および↓で判断間を移動し、Enterで開き、1~9で回答を選択し、⌘+Enterで適用します。
ファクトリー内で
ファクトリーのあなたの対応が必要判断が緊急の間、セキュリティ機能の行に1件が表示されます:"緊急判断5件・約2分・合計32件"。開始判断一覧を開きます。待機できない判断には個別の行が設定されます:悪用されたパッケージ、確認済みの重大な指摘、または実際に使用されていると確認された認証情報などです。
緊急事態がなくなると、『あなたの対応が必要』からその行が消え、次回セッションで対応可能な判断数が表示されます。
回答者
オーナーおよび管理者が判断に回答します。メンバーはそれらとその根拠を確認します。CoRoidのMCPおよびチャットツールにも同じ判断が一覧表示されます(list_security_needs)。MCPおよびチャットからのセキュリティ情報。