ドキュメントの全ページの一覧は、 llms.txt を参照してください。各ページの URL の末尾に .md を追加すると、そのページの Markdown 版を表示できます。
メインナビゲーション
テーマ

Daybreak へのスキャナーの検出結果のインポート

Wiz、Snyk Open Source、Endor Labs との接続方法、スキャナーレポートのアップロード方法、評価済みの検出結果から共有するものを選ぶ手順を説明します。

スキャナーを接続するか、レポートをアップロードすると、検出結果を Daybreak Defense Factory にインポートできます。Daybreak は、検出結果をコードと照合して評価し、共有条件を満たした結果をチームと共有できます。

設定 → 連携を開くか、検出結果でインポートを選択します。利用できるオプションはワークスペースによって異なります。評価には、スキャナーの証拠データとリポジトリのコミットへのアクセスが必要です。共有するには、検出結果を公開する権限がある環境も必要です。

接続済みのスキャナーからのインポート

  1. スキャナーの横にある接続を選択します。接続の有効期限が切れている場合は再接続、既存の接続を使う場合はインポートを選択します。
  2. インポート元と、取り込む検出結果を選択します。Snyk または Endor でリポジトリの検出結果をすべてインポートを利用できる場合は、接続済みの GitHub リポジトリを選択します。選択した組織または名前空間のうち、そのリポジトリに一致するすべてのプロジェクトが対象になります。それ以外の場合は、プロジェクトを選んでから検出結果を選択します。Wiz では、対応する保存済みビューも利用できます。
  3. 検出結果の件数と、評価対象のリポジトリとコミットを確認します。たとえば、12 件の検出結果をインポートに表示される件数には、評価できないものも含め、選択したスキャナーの検出結果 12 件がすべて含まれます。実際に共有される件数とは異なる場合があります。
  4. 確定すると何が行われるかを確認します。共有ワークスペースと公開先が表示されている場合、確定すると、評価の実行と、条件を満たした報告対象の結果をその公開先に公開することを許可したことになります。公開先にアクセスできるユーザーは、公開された評価と、その根拠となったスキャナーの証拠データを閲覧できます。条件を満たす環境が 1 つだけの場合は、Daybreak があらかじめ選択します。複数ある場合は、確定する前に 1 つ選択します。確認画面に非公開での評価、または保存のみのオプションが表示され、それを選んだ場合、結果は非公開のままです。
  5. 件数と公開先が正しければ確定します。確認内容の有効期限が切れた場合や、インポート元が変更された場合は、もう一度内容を確認します。インポートが開始したら、設定を閉じても、自分の最近のインポートで進捗を確認できます。

インポート元の選択

スキャナー 接続方法 選択できる対象
Wiz Wiz アカウントにサインインし、接続を承認します。 プロジェクト内のパッケージの脆弱性、または単一のコンテナリポジトリとコンテナイメージに絞り込んだ脆弱性検出結果の保存済みビューを選択できます。このページを絞り込むで検索できるのは現在のページ内です。検出結果は複数のページにまたがって選択できます。
Snyk Open Source REST API を通じて組織、プロジェクト、問題を読み取る権限を持つ Snyk US-01 の API トークンを使用します。 リポジトリを監視している組織を選択します。マニフェストごとに別の監視対象プロジェクトとして表示される場合があります。REST API へのアクセス権がない場合は、Issues Detail CSV を使用します。
Endor Labs 米国の名前空間、API キー、API シークレットを入力します。有効期限のある読み取り専用キーを使用し、対象範囲をその名前空間に限定して、子名前空間へのアクセスを無効にします。 プロジェクトのメインコンテキストから検出結果を選択するか、利用可能であればリポジトリ単位でインポートします。

Daybreak は、スキャナーが報告したリビジョンを検証できた場合、そのリビジョンを使用します。Snyk のデータにコミットが含まれていない場合、確認画面にそのリポジトリ向けの代替候補が表示されることがあります。チェックアウトが必要な Wiz の検出結果については、GitHub リポジトリを選択し、使用中の接続で読み取れるコミットの SHA を 40 文字すべて入力します。Daybreak が評価するのは、このコミットのコードです。コンテナイメージのビルドに使われたコードとは異なる場合があります。スキャナーの元の証拠データはインポート時に保持されます。

接続済みのスキャナーからインポートする際の上限

スキャナー インポート元から 1 回で読み取れる上限 上限に達した場合の対応
Wiz フィルター適用後のプロジェクトまたは保存済みビューごとに、一致する検出レコードは 5,000 件までです。1 ページ 50 件で最大 100 ページ、合計 32 MiB 以内です。 重大度、修正の有無、CVE のフィルターで対象を絞り込んでから、もう一度プレビューします。
Snyk Open Source 監視対象プロジェクトごとにパッケージの問題は 10,000 件までです。1 ページ 100 件で最大 100 ページです。エンコードした元のページと変換後のレポートの合計は 8 MiB 以内に収めてください。 規模の小さいプロジェクトを選択するか、対象を絞り込んでエクスポートしたファイルをアップロードします。プレビュー後に選択する問題を減らしても、プロジェクト全体の読み取りが必要です。
Endor Labs プロジェクトのプレビュー 1 回につき検出結果は 5,000 件までです。1 ページあたり最大 100 件で、読み取り量の上限は 32 MiB です。 規模の小さいプロジェクトを選択するか、対象を絞り込んでエクスポートしたファイルをアップロードします。証拠データ全体が上限を超える場合は、個別に選択する検出結果を減らします。

取得するレポートはそれぞれ、証拠データと合わせて 32 MiB 以内に収める必要があります。リポジトリ単位のインポートでは、一致するすべてのプロジェクトの読み取りが完了してから、そのリポジトリの検出件数を確定できます。

1 回の選択で取り込めるスキャナーの検出レコードは最大 10,000 件です。1 回の確認で評価できるのは、対象を検証できた行のうち最大 10,000 行です。行と各行に割り当てたリビジョンの一覧も 512 KiB 以内に収める必要があるため、選択件数が少なくても分割が必要な場合があります。Wiz のチェックアウトの上限は、チェックアウトを割り当てた検出結果の件数で数えます。複数の検出結果に同じコミットを使用する場合も、個別に数えます。1 回の確認で割り当てられる検出結果の上限は、ワークスペースで利用できる選択画面に応じて 16 件または 100 件です。表示された上限に合わせて選択を分けてください。1 回の確定で公開を許可できるのは、リポジトリ接続ごとに 1 環境、合計で最大 100 環境です。

スキャナーレポートのアップロード

スキャナーの横にあるファイルをアップロードを選択します。設定画面でファイル形式が自動検出され、ワークスペースで受け付けるエクスポート形式が表示されます。

スキャナー 設定画面でアップロードするファイル
Wiz Detailed JSON 形式の完全なパッケージ脆弱性レポート、または Wiz 独自形式の検出結果を 1 行に 1 件ずつ記録した JSON Lines ファイルを使用します。リポジトリ単位でエクスポートするには、Wiz の脆弱性の検出結果でレポートを絞り込み、名前を付けて保存 → レポートを選択して、リポジトリのブランチ、JSON、詳細を選択します。入力を求められたら、エクスポート元の Wiz テナント ID を入力します。
Snyk Open Source 1 つの組織からエクスポートした Issues Detail CSV を使用します。プレビューで組織を確認します。
Endor Labs インポートしたい名前空間について、endorctl でエクスポートした Endor Labs 独自の Finding JSON を使用します。元の検出結果の UUID を保持し、エクスポートが複数ページに分かれている場合は最後のページまで取得してください。

アップロードするファイルと展開後の内容は、それぞれ 32 MiB 以内に収めてください。gzip 圧縮ファイルにも同じ上限が適用されます。Snyk CSV と Wiz JSON Lines の場合、設定画面で認識できるのはファイルごとに最大 10,000 データ行です。これを超えるファイルは、アップロードする前に分割します。JSON 形式の検出結果が 1 件で 1 MiB を超える場合、その検出結果は拒否されることがあります。Snyk CSV では、ヘッダーは 32,768 文字以内、各フィールドは 131,072 文字以内、各論理行は 1,048,576 文字以内に収めてください。

評価と共有の選択

ファイルを保存すると、内容を確認できるようにファイルがアップロードされます。インポートを開始する前に、検証済みのリポジトリとコミット、チェックアウトの指定が必要な行、拒否された入力を確認します。

  • 証拠データを後で使うために保存するには、確認画面で評価を選べる場合は評価せずに保存、選べない場合は非公開で保存を選択します。
  • 条件を満たす行を評価し、すべての結果を非公開にするには、インポートして非公開で評価を選択します。評価対象が未指定の行については、後から対象を選択できます。対象が指定されている行が 10,000 行を超える場合は、レポートを分割するか、評価せずに保存します。
  • 条件を満たす結果を共有するには、報告対象の検出結果も公開にチェックを入れます。初期状態ではチェックは入っていません。ワークスペースと公開先を確認します。リポジトリに公開先として選べる環境が複数ある場合は、1 つ選ぶか、非公開のままにするを選択します。インポートして報告対象の検出結果を公開で確定します。

自動共有の条件は、評価結果が「報告対象」であること、スキャナーが重大度を報告していること、公開を許可した宛先があることです。元のレポートは非公開のままです。アクティビティで自動共有を停止を選択すると、そのインポートからの今後の公開が停止します。

CLI からのインポート

codex-security publish findings を使って、保存済みのスキャナーのエクスポートファイルをインポートできます。ローカルでプレビューするには --to local --dry-run を使用します。クラウドへのインポートをプレビューするには、接続済みのリポジトリで --to cloud --dry-run --format json を使用します。クラウドでのプレビューでは Daybreak と通信するため、ChatGPT のログイン情報がファイルに保存されている必要があります。

プレビューの内容を確認してから、--dry-run を外して確定します。privateImport エントリがある場合、検出結果は自分の非公開の受信トレイに保存されます。requests 内のエントリは、そこに記載されたリポジトリの環境に公開されます。処理結果の記録で、除外された行、処理に失敗した行、未処理の行を確認してください。ローカルとクラウドへのインポート例は CLI リファレンスを、CLI で扱える形式とコマンドはスキャナーからのインポートガイドを参照してください。

インポート内容の再確認

インポートを実行したワークスペースで、設定 → 連携または検出結果 → インポートから自分の最近のインポートを開きます。非公開のインポートは、スキャンの該当行からも開けます。概要には各行の処理結果が表示され、拒否された入力についてはその理由も確認できます。受け付けられた行を開くと、スキャナー ID と保存された証拠データに加え、評価や公開済みの検出結果があればそれらも確認できます。スキャナーの接続を解除すると、その接続を使った新たな読み取りは停止します。保存済みのインポートは引き続き開けます。

非公開の検出結果で評価を選択すると、証拠データを選択したコミットと照合できます。報告対象、保留、抑制、該当なしの横に表示される理由を確認します。たとえば、Daybreak がコミットを読み取れない場合、検出結果が「保留」のままになることがあります。非公開で評価した「報告対象」の結果を共有するには、公開権限のある環境を選び、共有の検出結果として公開を選択します。スキャナーから認識可能な重大度が提供されていない場合は、公開する前に重大度を選択してください。

同じ検出結果を再インポートした場合の動作

確定処理が中断した場合は、元の処理結果の記録を開き直すか、元のインポートを確認が表示されていれば選択します。元のリクエストを再試行すると、選択済みの内容を保持したまま、そのインポートを復元できます。

新しいインポートを開始すると、Daybreak は各行を既存の証拠データと比較します。

  • Endor で同じ接続とプロジェクトを使う場合や、Wiz で同じ接続を使い、同じプロジェクトまたは同じ保存済みリポジトリビューを選ぶ場合、スキャナー ID と証拠データに変更がなければ、既存の非公開の観測記録が参照されることがあります。接続済みの Snyk から新たにインポートすると、問題ごとに新しい非公開の観測記録が作成されます。再度評価をリクエストすると、変更のない行も評価される場合があります。
  • 同じ組織について同一の Snyk CSV をアップロードすると、すでに受け付けられた行が再利用されます。たとえば、同じ 5 件の問題を再度アップロードすると、変更なしが 5 件、新規が 0 件と表示されることがあります。証拠データが変わると、新しいバージョンが作成されます。以前の評価は、引き続きその評価で確認した証拠データとコミットを参照します。
  • 1 つのレポートに同じスキャナーの検出結果 ID が 2 回含まれている場合、Daybreak は両方のレコードに重複を示す印を付けます。他の有効な行はインポートできます。正しいレコードを 1 件だけ残し、修正したレポートをインポートしてください。同じ CVE を参照していても、ID が異なる場合は、影響を受けるパッケージやリポジトリが異なることがあります。

公開後、Daybreak は同じリポジトリと環境に既存の共有済みの検出結果があるかを確認します。一致するものがあれば、その問題に公開された証拠データを追加します。別の問題であれば、新しい検出結果が作成される場合があります。そのため、スキャナーの 2 件の観測記録が 1 件の共有済みの検出結果に表示されることがあります。同じ公開処理を再試行しても、証拠データが重複して追加されることはありません。共有済みの検出結果で観測記録を開くと、その情報源を確認できます。検出結果と修正内容の確認を参照してください。