Skip to content

雲端服務設定 – Codex Security ​

本頁是 OpenAI 官方文件 的中文鏡像,譯文由官方維護。以官方頁面為準。

本頁將引導你使用 Codex Security 雲端服務,從取得初始存取權到審查發現項目,並建立修正用 Pull Request。

請先確認已完成 Codex 雲端設定。若尚未設定,請參閱 Codex 雲端 以開始使用。

1. 存取權與環境 ​

Codex Security 雲端服務會掃描已透過 Codex 雲端 連線的 GitHub 程式碼庫。

  • 請確認你的工作區可存取 Codex Security 雲端服務。
  • 請確認要掃描的程式碼庫已可在 Codex 雲端中使用。

前往 Codex 環境,檢查該程式碼庫是否已有環境。若沒有,請先在該處建立環境再繼續。

2. 新增安全性掃描 ​

環境建立後,前往 建立安全性掃描,然後選擇剛才連線的程式碼庫。

Codex Security 會先從最新的提交開始,往回掃描程式碼庫,藉此建立掃描上下文,並在有新提交時更新該上下文。

若要設定程式碼庫:

  1. 選取 GitHub 組織。
  2. 選取程式碼庫。
  3. 選取要掃描的分支。
  4. 選取環境。
  5. 選擇 歷史記錄範圍。範圍越長,可提供的上下文越多,但回溯掃描所需時間也越長。
  6. 按一下 建立。

3. 初始掃描可能需要一段時間 ​

建立掃描後,Codex Security 會先在所選的歷史記錄範圍內執行提交層級的安全性掃描。 初始回溯掃描可能需要數小時,程式碼庫較大或歷史記錄範圍較長時尤其如此。 如果沒有立即顯示發現項目,這是正常現象。請先等待初始掃描完成,再建立問題單或進行疑難排解。

系統會自動且完整地設定初始掃描,這可能需要數小時。 如果第一批發現項目延遲出現,不必擔心。

4. 審查掃描並改善威脅模型 ​

初始掃描完成後,開啟該掃描並審查系統產生的威脅模型。 初始發現項目出現後,更新威脅模型,使其符合你的架構、信任邊界及業務上下文。 這有助於 Codex Security 為團隊判定問題的優先順序。

如果想改變掃描結果,可以編輯威脅模型,納入更新後的 範圍、優先順序及假設。

初始發現項目出現後,請重新檢視模型,讓掃描指引與目前的優先事項保持一致。 持續更新模型有助於 Codex Security 提供更好的建議。

如需深入瞭解威脅模型及其對嚴重程度判定與分流處理的影響,請參閱 改善威脅模型。

5. 審查發現項目並進行修補 ​

初始回溯掃描完成後,請在 發現項目 檢視畫面中審查發現項目。

你可以使用兩種檢視畫面:

  • 建議的發現項目:持續更新的清單,列出程式碼庫中最嚴重的 10 個問題
  • 所有發現項目:可排序及篩選的表格,列出整個程式碼庫的發現項目

按一下發現項目即可開啟其詳細資料頁面,其中包含:

  • 問題的簡要說明
  • 重要中繼資料,例如提交詳細資訊和檔案路徑
  • 結合上下文對影響進行推理
  • 相關程式碼片段
  • 呼叫路徑或資料流上下文(如有)
  • 驗證步驟及驗證輸出

你可以審查每個發現項目,並直接從發現項目詳細資料頁面建立 PR。

相關文件 ​

非官方社群教程 · 「官方文件」區為 learn.chatgpt.com 中文原文映象 · 以官方頁面為準