メインコンテンツへスキップ

概要

Vulnerabilitiesページでは、組織全体の未対応のセキュリティ検出結果を一覧できます。各スキャンを個別に開かなくても、プロジェクト横断で検出結果を確認し、詳細を調査し、結果をエクスポートし、トリアージの判断を適用できます。
Vulnerabilities Workbenchは、Corgeaによって有効化された組織で利用できます。アクセスを希望する場合はCorgeaの担当者に連絡してください。ユーザーには、ロールで付与されるCan view vulnerabilities workbench権限と、少なくとも1種類の問題を表示する権限が必要です。更新前から問題の表示権限を持つユーザーとロールは、更新後もアクセスできます。
検出結果タイプのタブ、ステータス操作、検索、フィルターアイコン、グループ化された検出結果があるVulnerabilities Workbench
検出結果は次のタブに分かれます。
  • Secrets
  • SAST
  • Logic & Auth
  • SCA Packages
  • Containers
  • IaC
各タブは、その検出結果の種類を表示する権限がある場合にのみ利用できます。タブ上のバッジは、フィルター適用前の未対応検出結果数を示します。1,000件以上は省略表示されます(例: 1.8K)。 Workbenchに Almost ready と表示される場合、Corgeaが組織向けに利用の準備を進めています。準備が完了するまで、検出結果の件数、一覧、エクスポート、一括選択は利用できません。
Almost readyと表示されたVulnerabilities Workbench

検出結果の検索と確認

タブを選択し、グループとプロジェクトを展開して個々の検出結果に移動します。グループ分けは検出結果の種類ごとに異なります。たとえば、SCAはパッケージ、コンテナはイメージ、IaCはルールから始まります。1,000件以上の件数は省略表示されます(例: 24.6K)。省略された件数にポインターを合わせると、正確な件数が表示されます。プロジェクトの行にあるアイコンから、プロジェクトページを新しいタブで開けます。 Previous、Next、および表示されている場合はページ番号で、グループ化された結果を移動します。各一覧には現在の行範囲と、Corgeaが総件数を持っている場合はその総件数が表示されます。 ステータス操作でOpen、Fixed、False Positive、およびその検出結果の種類で利用可能なその他のステータスを切り替えられます。フィルターアイコンをクリックすると、重大度、プロジェクト、チーム、タグのフィルターが表示されます。行を隠している間、アイコンの数字は設定中のフィルター数を示します。行を隠してもフィルターは有効なままです。複数のタグを選択すると、選択したタグのいずれかを持つプロジェクトの検出結果が表示されます。タグの一致は大文字と小文字を区別し、保存されているプロジェクトタグと完全に一致する必要があります。SCA Packagesタブでは、メインのツールバーに到達可能性フィルターが追加されます。
フィルター行を開き、タグ検索を表示したTagsメニューのあるSASTタブ
Secrets、SAST、Logic & Auth、IaC でファイルパスを検索するには、Project フィルターを明示的に設定する必要があります。プロジェクトのグループを展開するだけでは、ファイルパス検索は有効になりません。このフィルターがない場合、タブに応じてシークレットのサブタイプ、CWE、IaCルールが検索対象になります。同じ検索範囲が、グループの件数、エクスポート、一括選択にも適用されます。
パッケージのグループ、重大度、Reachableの切り替えを表示したSCA Packagesタブ
各タブのTeamフィルターを使うと、選択したチームが所有するプロジェクトのうち、表示権限のあるプロジェクトの検出結果に絞り込めます。プロジェクトフィルターと併用すると、両方の条件に一致するプロジェクトだけが表示されます。チームフィルターは、グループの展開、絞り込んだ結果のエクスポート、現在のフィルターに一致するすべての検出結果の選択にも適用されます。
フィルター行が開き、Teamメニューでチーム検索が表示されているVulnerabilities Workbench
検出結果を選択すると、スキャンページと同じ詳細パネルが開きます。自動トリアージの判断理由がある場合は、初期状態で選択されるAuto-Triageタブに表示されます。スキャン中に読み込まれたファイルはFiles Readタブで確認できます。証跡の確認、担当者の割り当て、Current Statusによるステータス変更ができます。Open Full Viewが表示されている場合は、検出結果の全画面を開けます。アドレスバーには選択した検出結果が残るため、同じリンクを開き直すと、その検出結果が現在の結果に残っていればパネルが復元されます。対応方針を変更するときは、決定を繰り返すだけでなく理由を説明するコメントが必要です(トリアージの理由を参照)。対応する検出結果を受け入れ済みリスクにする場合は、有効期限も選べます。 スキャン結果の再検証は既定で無効です。有効にする場合は、Corgeaのサポートにお問い合わせください。有効な場合、増分スキャン、全体スキャン、プルリクエストのスキャンは、新しいスキャンで再び報告されなかった以前のSASTの検出結果を再確認します。検出結果がまだ存在するとCorgeaが確認した場合、その検出結果は新しい結果に引き継がれます。全体スキャンでは、以前のスキャンから変更されていないファイルの検出結果も引き継がれます。再確認を完了できなかった場合、Corgeaは検出結果を未確認のまま、トリアージを変えずに引き継ぎます。再確認が完了しても判断できなかった場合、検出結果は以前のスキャンに残ります。新しい結果に表示されないことだけでは、修正済みとは判断できません。メインブランチでは、再確認によって削除が確認された検出結果を修正済みにできます。同じプルリクエストへの後続のプッシュでも、コードの変更によって削除が確認された検出結果をCorgeaが修正済みにします。ただし、同じ検出結果がプルリクエスト外でまだ未解決の場合は修正済みにしません。 再確認の根拠がある場合、検出結果の詳細の Auto-Triage タブでは、その根拠が Re-checked against the current version of this file の下に表示されます。最初の根拠は、その下の From the scan that found it に表示されます。
Re-checked against the current version of this file の下に再確認の根拠、その下の From the scan that found it に最初の根拠が表示された Auto-Triage タブ
以前のスキャンから引き継がれるSASTの検出結果は、未確認のまま引き継がれたものも含め、トリアージのステータス、理由、担当者、期限、受け入れ済みリスクの有効期限を保持します。検出結果を引き継いでも、期限や有効期限はリセットされたり削除されたりしません。 Corgeaが位置の修正された問題を認識すると、既存のトリアージ判断を引き継ぐ場合があります。新しい問題にすでに判断がある場合は上書きしません。ブランチの増分スキャンでは、変更されていないファイル内の同じ問題も以前の判断を引き継げます。そのスキャンで変更されたファイル内の問題は、確認のため未解決のままになります。問題の履歴にはDecision carried over from the finding’s previous locationが表示され、情報がある場合は以前の位置と元の判断日も示されます。 SCAとコンテナの検出結果では、同じパネルにパッケージの詳細と履歴が表示され、利用できる場合は到達可能性も確認できます。 会社で False positive または Accepted risk のトリアージ承認が必須の場合、Secrets、SAST、Logic & Auth、SCA Packages の問題をその対応方針に変えると申請が作成され、問題のステータスは変わりません。Containers と IaC はすぐに変わります。別の権限を持つ確認担当者が、承認キューまたは問題の詳細から申請を承認または却下できます。申請者は、自分の保留中の申請を取り下げられます。 レビュー待ちの検出結果には、Workbenchと、スキャンページで展開した検出結果のグループで、現在のステータスの横に Pending approval バッジが表示されます。
スキャンページで展開した検出結果のグループ。Openのステータスの横にPending approvalバッジが表示されています

検出結果のエクスポート

ExportをクリックするとCSVエクスポート画面が開きます。現在のタブとフィルターに一致する問題を選ぶか、Export selectionで選択済みの問題をエクスポートします。フィルターによるエクスポートには現在の状態、検索、フィルターが引き継がれ、確定前に画面内で編集できます。選択済みの問題のエクスポートでは、これらのフィルターの代わりに選択内容(最大1,000件)を使います。各問題の最新の検出がエクスポートされます。検出結果を選択している場合、ツールバーのExportも既定で選択した結果を対象にします。選択がない場合は、フィルターで絞り込んだ表示が対象になります。 フィルターに基づいてエクスポートする場合、最初に検出の種類を1つ以上選び、Next をクリックします。選択した種類はすべて Finding Type 列を持つ1つのCSVにまとめられます。開いていたタブから引き継いだフィルターを確認してください。選択した種類で共有できないフィルターを削除する前に警告が表示されます。 CSVの2列目は Finding Type です。依存関係の問題は SCA と表示され、First Detection Date と Last Detection Date も含まれます(不明な場合は空欄)。Fix Status と Scan Metadata は含まれなくなりました。
Secrets、SAST、Logic & Authを選択したVulnerabilities Workbenchのエクスポート画面のステップ1
Vulnerabilities Workbenchからのエクスポートは、CSV形式のみです。機密データに関する注意事項に同意すると、最後のボタン(Download、バックグラウンドで作成するエクスポートでは Start export)が有効になります。CSVの上限は既定で150,000行ですが、環境によって異なる場合があります。30,000行以下のエクスポートはCSVでダウンロードされます。それより大きいエクスポートは、CSVと export-criteria.txt を含むZIPで提供されます。export-criteria.txt には対象範囲、フィルター、行数、依頼者、依頼日時、同意内容が記録されます。作成中は画面を閉じてもかまいません。ファイルの準備ができるとCorgeaのアプリ内で通知されます。処理に時間がかかる場合は、進捗とダウンロードリンクをメールで送信する旨が画面に表示されます。準備ができたら Download CSV または Download ZIP を使います。Recent exports の View progress から、作成中のエクスポートに戻れます。ファイルは12時間 Recent exports から取得できます。有効期限切れや失敗したエクスポートのページでは Build it again を利用でき、同じ種類とフィルターで現在の検出から再作成し、準備ができるとリンクをメールで送信します。上限を超える場合はエクスポートが拒否されるため、フィルターを絞って再試行してください。 エクスポート画面に、今すぐ作成する旨が表示された場合は、ダウンロードが完了するまで画面を開いたままにしてください。エクスポートのバックグラウンド処理を利用しない環境では、大きなエクスポートにかかる時間の目安が表示されます。
3種類の検出、Status: Openフィルター、CSV形式、機密データに関する確認を表示したVulnerabilities Workbenchのエクスポート画面のステップ2

検出結果の一括トリアージ

個々の検出結果、または展開したグループを選択します。最初の選択後にSelect all findings matching the current filtersを選ぶこともできます。 一括アクションバーでは次の操作ができます。
  • チームメンバーへの割り当て
  • 再オープンやリスクの受け入れを含め、現在のタブが対応する別のステータスへの変更
  • 選択内容のエクスポート
選択した問題数、プロジェクト数、チーム数と、Assign、Change status、Export selection、Clearを示す一括アクションバー
Change statusをクリックし、Decisionを選択して、変更理由をコメントに記入します。メニューには、いま表示しているステータスを除く、そのタブのステータスが出ます。Accepted Riskでは、Expiry Date (Optional)に未来の日時を入れるか、期限を設けない場合は空欄にします。その日時を過ぎると、問題はOpenに戻り、Corgeaが通知を送ります。IaCの問題に有効期限はありません。会社で承認が必須の場合、Secrets、SAST、Logic & Auth、SCA PackagesでのFalse positiveまたはAccepted Riskへの一括変更は承認申請になり、承認されるまでステータスは変わりません。ContainersとIaCはすぐに変わります。トリアージ申請を承認できる人は、どのタブでもその場で変更を適用します。
Decisionのメニューと必須コメントがあるChange Statusダイアログ。Accepted Riskを選ぶとExpiry Dateが表示される
一括でのステータス変更にはコメントが必要で、同じ理由の要件が適用されます。決定を繰り返すだけのコメントは拒否され、ステータスは変更されません。アクションバーには選択した検出結果数、プロジェクト数、チーム数が表示され、スキップされた検出結果も報告されます。一括選択は最大1,000件までです。
割り当てと対応方針の操作は、その検出結果の種類を変更する権限がある場合にのみ表示されます。エクスポートは表示権限があれば利用できます。