你可以連接掃描器或上傳報告,將發現項目匯入 Daybreak Defense Factory。Daybreak 可以根據你的程式碼評估這些項目,並與團隊分享符合條件的結果。
開啟設定 → 整合,或在發現項目中選取匯入。可用選項依工作區而異。Daybreak 必須能存取掃描器提供的證據和程式碼庫中的提交,才能進行評估。若要分享結果,還需要一個你有權發布發現項目的環境。
從已連線的掃描器匯入
- 選取掃描器旁的連接。如果連線已過期,請選取重新連接。若要使用現有連線,請選取匯入。
- 選擇來源和要匯入的發現項目。如果 Snyk 或 Endor 提供匯入程式碼庫的所有項目選項,請選擇一個已連線的 GitHub 程式碼庫,即可納入所選組織或命名空間中與該程式碼庫相符的所有專案。若無此選項,請選擇一個專案,再選取發現項目。在 Wiz 中,你也可以使用支援的已儲存檢視畫面。
- 核對發現項目數量,以及評估時要使用的程式碼庫和提交。舉例來說,匯入 12 個發現項目中的數量包含所選的全部 12 個掃描器發現項目,即使其中有些項目無法評估。這個數量可能與分享的項目數量不同。
- 查看確認後會執行哪些操作。如果畫面列出共用工作區和發布目的地,確認即代表你授權 Daybreak 進行評估,並將符合條件的可回報結果發布至該目的地。有權存取該目的地的人都可以閱讀已發布的評估和來源證據。如果只有一個環境符合條件,Daybreak 會預先選取該環境。如果有多個環境符合條件,請先選擇其中一個再確認。如果檢閱畫面提供的選項是私下評估或僅儲存,結果會保持私密。
- 核對數量和目的地後再確認。如果檢閱內容已過期或來源有變動,請重新檢閱。匯入開始後,你可以關閉「設定」,並在我最近的匯入中追蹤進度。
選擇來源
| 掃描器 | 連線方式 | 可選取的項目 |
|---|---|---|
| Wiz | 登入 Wiz 帳戶並核准連線。 | 可選擇專案中的套件漏洞,或使用已儲存的漏洞發現項目檢視畫面,其中的篩選範圍須限於單一容器映像檔存放庫及容器映像檔。篩選此頁面只會搜尋目前的頁面。你可以跨頁選取發現項目。 |
| Snyk Open Source | 使用具備組織、專案和問題 REST 讀取權限的 Snyk US-01 API 權杖。 | 選擇監控該程式碼庫的組織。不同的資訊清單可能會各自列為獨立的受監控專案。如果你沒有 REST 存取權,請改用 Issues Detail CSV。 |
| Endor Labs | 輸入你的美國命名空間、API 金鑰和 API 密鑰。請使用設有到期日的唯讀金鑰,將其權限限於該命名空間,並停用子命名空間存取權。 | 從專案的主要上下文選擇發現項目。如果可以按程式碼庫匯入,也可以使用該選項。 |
如果 Daybreak 能驗證掃描器回報的修訂版本,就會使用該版本。如果 Snyk 未提供提交,檢閱畫面可能會提供該程式碼庫的備用選項。如果 Wiz 發現項目需要簽出程式碼,請選擇 GitHub 程式碼庫,並輸入目前連線可讀取的提交 SHA(完整的 40 個字元)。Daybreak 會評估該提交的程式碼,這份程式碼可能與建置容器映像檔時使用的程式碼不同。匯入時會保留掃描器的原始證據。
在限制範圍內透過連線匯入
| 掃描器 | 單次讀取來源的限制 | 達到上限時的處理方式 |
|---|---|---|
| Wiz | 每個篩選後的專案或已儲存的檢視畫面最多可讀取 5,000 筆相符記錄,每頁 50 筆,最多 100 頁,總計不得超過 32 MiB。 | 調整嚴重性、是否有可用修正或 CVE 的篩選條件,縮小範圍後再預覽。 |
| Snyk Open Source | 每個受監控專案最多可讀取 10,000 個套件問題,每頁 100 個,最多 100 頁。編碼後的原始頁面加上轉換後的報告合計不得超過 8 MiB。 | 選擇較小的專案,或上傳篩選過的匯出檔。即使在預覽後減少選取的問題數量,仍須讀取整個專案。 |
| Endor Labs | 每次預覽專案時最多可讀取 5,000 個發現項目,每頁最多 100 個,讀取總量不得超過 32 MiB。 | 選擇較小的專案,或上傳篩選過的匯出檔。如果完整證據超過上限,請個別選取較少的發現項目。 |
每份擷取的報告連同其證據合計不得超過 32 MiB。按程式碼庫匯入時,必須讀完所有相符的專案,才能確認該程式碼庫的項目總數。
每次最多可選取 10,000 筆掃描器記錄。每次檢閱最多可評估 10,000 列已有驗證目標的資料。資料列清單連同各列指定的修訂版本也不得超過 512 KiB,因此即使選取的資料列數較少,也可能需要分批處理。對 Wiz 而言,簽出上限是按已指定簽出目標的發現項目數計算,即使多個項目使用同一個提交,也會分別計數。依工作區提供的選取介面而定,每次檢閱最多可為 16 或 100 個發現項目指定簽出目標。請依畫面顯示的上限分批選取。每次確認最多可授權 100 個目的地環境,每個程式碼庫連線可指定一個。
上傳掃描器報告
選取掃描器旁的上傳檔案。「設定」會偵測檔案格式,並顯示工作區接受哪些匯出格式。
| 掃描器 | 可在「設定」中上傳的檔案 |
|---|---|
| Wiz | Detailed JSON 格式的完整套件漏洞報告,或每行包含一個原生發現項目的 JSON Lines 檔案。在 Wiz 的漏洞發現項目中篩選報告,選取另存為 → 報告,再選擇程式碼庫分支、JSON 和詳細以匯出程式碼庫報告。系統提示時,請輸入匯出報告的 Wiz 租用戶 ID。 |
| Snyk Open Source | 單一組織的 Issues Detail CSV。請在預覽中核對組織。 |
| Endor Labs | 使用 endorctl 從要匯入的命名空間匯出的原生 Finding JSON。保留發現項目的原始 UUID。如果匯出資料有分頁,請匯出所有頁面。 |
上傳的檔案和解壓縮後的內容各自不得超過 32 MiB,gzip 上傳檔也適用此限制。對於 Snyk CSV 和 Wiz JSON Lines,「設定」每個檔案最多可辨識 10,000 列資料。如果檔案超過上限,請先分割再上傳。單一 JSON 發現項目若超過 1 MiB,可能會遭拒。對於 Snyk CSV,標頭不得超過 32,768 個字元,每個欄位不得超過 131,072 個字元,每個邏輯資料列不得超過 1,048,576 個字元。
選擇是否評估或分享
儲存檔案時,系統會將檔案上傳以供檢閱。開始匯入前,請核對已驗證的程式碼庫和提交、仍需指定簽出目標的資料列,以及遭拒的輸入資料。
- 若要保留證據供日後使用,請在檢閱畫面提供評估選項時選擇儲存但不評估。如果沒有評估選項,請選擇私下儲存。
- 若要評估符合條件的資料列並將所有結果保留為私密,請選擇匯入並私下評估。對於仍需要目標的資料列,你可以稍後再選擇目標。如果已有目標的資料列超過 10,000 列,請分割報告,或僅儲存報告而不進行評估。
- 若要分享符合條件的結果,請勾選預設未勾選的同時發布可回報的發現項目。核對工作區和目的地。如果某個程式碼庫有多個符合條件的環境,請選擇其中一個,或選取保持私密。選取匯入並發布可回報的發現項目以確認。
Daybreak 只會在評估結果為「可回報」、掃描器已回報嚴重性,且你已授權發布目的地時自動分享。原始報告會保持私密。若要停止日後自動發布這次匯入的結果,請在活動中選取停止自動分享。
從 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 無法讀取提交,發現項目可能會維持「已暫緩」狀態。若要分享經私下評估為「可回報」的結果,請選取已授權的目的地環境,再選取發布至共用發現項目。如果掃描器未提供可辨識的嚴重性等級,請在發布前選擇一個等級。
辨識重複匯入
如果確認程序中斷,請重新開啟原始匯入收據,或在畫面提供檢查原始匯入選項時選取該選項。重試原始要求會恢復該次匯入,並保留你先前的選擇。
開始新的匯入時,Daybreak 會將每一列與現有證據比對。
- 如果使用相同的 Endor 連線和專案,或透過相同的 Wiz 連線使用同一個專案或同一個已儲存的程式碼庫檢視畫面,只要掃描器 ID 和證據均未變更,資料列就可能對應至現有的私人觀察記錄。每次透過 Snyk 連線執行新的匯入,都會為每個問題建立新的私人觀察記錄。再次要求評估時,即使資料列未變更,也可能會重新評估。
- 為同一個組織再次上傳完全相同的 Snyk CSV 時,會沿用先前已接受的資料列。例如,再次上傳相同的五個問題,畫面可能會顯示五個未變更、零個新增。證據有變動時,Daybreak 會建立新版本。先前的評估仍對應至當時檢閱的證據和提交。
- 如果同一份報告中有兩筆記錄使用相同的掃描器發現項目 ID,Daybreak 會標記這兩筆記錄,其他有效資料列仍可匯入。請保留一筆正確的記錄,再匯入修正後的報告。即使引用同一個 CVE,不同的 ID 也可能代表不同的受影響套件或程式碼庫。
發布後,Daybreak 會在同一個程式碼庫和環境中查找現有的共用發現項目。如果找到相符項目,就會將已發布的證據加入該問題。如果是不同的問題,則可能會建立新的發現項目。因此,同一個共用發現項目中可能會出現兩筆掃描器觀察記錄。重試同一次發布時,系統不會重複加入證據。若要查看來源,請開啟共用發現項目中的觀察記錄。請參閱檢閱發現項目與修正內容。