如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題
Codex

Codex 應用案例

執行第一次安全掃描

找出程式碼中的漏洞,檢視證據,判斷哪些問題需要處理。

難度 Intermediate
任務時間跨度 Long-running

使用 Codex Security 外掛程式掃描本機程式碼庫,檢視證據與掃描涵蓋範圍,決定優先調查或修正哪些問題。

最適合的對象

  • 需要評估程式碼庫或服務,且為其擁有者或已獲授權審查的開發者。
  • 需要初步掌握漏洞狀況,並找出哪些部分需要進一步審查的資安團隊。
  • 需要先檢視程式碼中的證據與驗證結果,再決定要修正哪些問題的審查人員。

目錄

    ← 所有應用案例

    執行第一次安全掃描

    找出程式碼中的漏洞,檢視證據,判斷哪些問題需要處理。

    使用 Codex Security 外掛程式掃描本機程式碼庫,檢視證據與掃描涵蓋範圍,決定優先調查或修正哪些問題。

    Intermediate
    Long-running

    使用 Codex Security 外掛程式掃描本機程式碼庫,檢視證據與掃描涵蓋範圍,決定優先調查或修正哪些問題。

    Intermediate
    Long-running

    最適合的對象

    • 需要評估程式碼庫或服務,且為其擁有者或已獲授權審查的開發者。
    • 需要初步掌握漏洞狀況,並找出哪些部分需要進一步審查的資安團隊。
    • 需要先檢視程式碼中的證據與驗證結果,再決定要修正哪些問題的審查人員。

    技能與外掛程式

    技能 使用理由
    Codex Security:security Scan 掃描程式碼庫或指定的資料夾,驗證疑似漏洞,並回報發現的問題與掃描涵蓋範圍。

    入門提示詞

    使用 $codex-security:security-scan 對 [absolute path to this repository or one scoped folder] 執行標準安全掃描。 我已獲授權評估這份程式碼。請將審查限於選定範圍。 請遵循程式碼庫的安全指引,並使用該程式碼庫支援的驗證指令。 請勿套用修正,也不要將發現的問題標記為已結案。 請提供掃描報告,並摘要說明下列事項: - 發現的問題、受影響的程式碼,以及實際可能造成的影響。 - 驗證所得的證據,以及仍不確定之處。 - 已審查的部分、排除的項目,以及掃描未完整涵蓋的部分。 - 在發現的問題與掃描未涵蓋的部分中,哪些需要優先由人工審查。
    使用 $codex-security:security-scan 對 [absolute path to this repository or one scoped folder] 執行標準安全掃描。 我已獲授權評估這份程式碼。請將審查限於選定範圍。 請遵循程式碼庫的安全指引,並使用該程式碼庫支援的驗證指令。 請勿套用修正,也不要將發現的問題標記為已結案。 請提供掃描報告,並摘要說明下列事項: - 發現的問題、受影響的程式碼,以及實際可能造成的影響。 - 驗證所得的證據,以及仍不確定之處。 - 已審查的部分、排除的項目,以及掃描未完整涵蓋的部分。 - 在發現的問題與掃描未涵蓋的部分中,哪些需要優先由人工審查。

    使用 Codex Security 外掛程式掃描本機程式碼庫,檢視每項發現的證據,再判斷哪些問題需要調查或修正。先從一個程式碼庫或一項服務開始,確認掃描涵蓋了哪些部分,再擴大範圍。

    開始之前

    在 Codex 中開啟你擁有或有權評估的本機程式碼庫。安裝並啟用 Codex Security 外掛程式,並確認你的帳戶和工作區具備所需的安全性存取權限。

    先對程式碼庫或其中一項服務執行標準掃描。標準掃描會執行一次掃描流程,列出掃描發現、佐證資料及涵蓋範圍,供你檢視後決定要修正哪些問題。如果是大型單體程式碼庫,請選擇一個服務或產品界線明確的資料夾。

    在該程式碼庫的 Codex 專案中使用起始提示詞,將其中的路徑換成你要掃描的路徑。你也可以按照執行第一次掃描的步驟,在「安全性」側邊欄中設定相同的掃描。選擇其中一種方式啟動掃描即可。

    執行第一次掃描

    1. 開啟安全性,選取掃描,再選取 + 掃描。
    2. 選取程式碼庫,確認目前分支和最近一次提交對應到你要檢查的程式碼。程式碼集會掃描目前簽出的程式碼,包括本機變更。
    3. 選取程式碼集,將掃描區域設為整個程式碼集或單一資料夾。第一次掃描時,請保持深度掃描關閉。
    4. 參考最新的掃描建議,選擇模型和推理強度。
    5. 如需說明安全性規則或指定優先檢查的範圍,請開啟其他上下文並填寫說明,然後選取開始掃描。

    如果應用程式將每位客戶的資料分別存放在獨立的工作區,你可以補充以下安全性規則與檢查重點:

    系統必須確保使用者只能從自己所屬的工作區擷取文件。
    請檢查使用者是否能提供其他工作區的識別碼,藉此擷取該工作區的私人文件。
    請確認系統在哪些環節依工作區成員資格限制存取。檢查範圍須包括背景作業和直接呼叫 API 的情況。

    安全性文件中的掃描設定範例。開始前,請確認你要掃描的程式碼庫、範圍和設定。

    追蹤掃描進度並檢查涵蓋範圍

    Codex 會辨識應用程式的資產與安全邊界,檢查程式碼以找出潛在漏洞,再逐一驗證並評估其影響,最後產生報告。選取檢視活動可查看執行掃描的 Codex 任務,接著等待掃描完成。

    開啟已完成的掃描,確認掃描目標和程式碼版本。先檢視涵蓋範圍,包括略過或延後檢查的部分,再閱讀掃描發現。掃描完成後,結果中仍可能列有漏洞。如果掃描未完整涵蓋目標範圍,即使發現清單是空的,也不足以證明程式碼安全。

    如果掃描中途停止或有部分範圍未涵蓋,請記下這些部分,以便後續追蹤。掃描所需的時間與資源取決於所選的程式碼及需要進行的驗證工作。

    解讀掃描發現

    選取一項發現並開啟摘要。請一併檢視以下問題:

    • 攻擊者能做什麼? 檢視受影響的程式碼、根本原因及報告所述的影響。
    • 攻擊者如何觸及敏感操作? 從攻擊者可控制的輸入開始,沿著攻擊路徑追蹤到敏感操作,並檢查沿途既有的防護措施。
    • 掃描驗證了什麼? 檢視驗證證據、嚴重程度的判定依據,以及仍未釐清之處。單憑嚴重程度標籤,不足以認定問題成立。

    此掃描發現取自安全性文件,並非執行本教學步驟所得的結果。

    在這個範例中,應用程式使用請求提供的工作區識別碼擷取私人文件,過程中沒有檢查使用者是否為該工作區的成員。如果在你的程式碼中發現類似問題,請檢查是否有其他機制限制只有工作區成員才能存取文件,以及驗證結果是否證實使用者能跨工作區存取文件。

    如需協助解讀某項發現,請在同一個程式碼庫專案中開啟對話,提供該項發現的標題、受影響的程式碼及證據:

    請協助我評估這項安全性掃描發現:[paste the finding, affected code, and validation evidence]。 請說明攻擊路徑、既有的防護措施,以及證據是否足以支持報告所述的影響和嚴重程度。請引用相關程式碼,並指出還缺少哪些資訊。請勿修改程式碼或關閉這項發現。

    決定下一步

    針對每項已檢視的發現,簡要記錄掃描的程式碼版本、受影響的程式碼、證據、仍未釐清之處及負責團隊。根據證據決定下一步:

    • 需要修正: 選取一項已確認成立的發現,接著按照修正安全性掃描發現的問題的步驟處理。
    • 需要調查: 將這項發現保持開啟,先釐清還需要哪些檢查或資訊,再決定如何處理。
    • 無需修正: 記錄佐證資料及分類處理的決定。關閉這項發現只會記錄該決定,程式碼不會因此變更。

    完成檢視後,你會整理出掃描發現和未涵蓋的部分,並為每一項訂出後續行動。如需更全面的評估,請參閱執行深度安全性掃描。如要評估特定 pull request 或程式碼差異,請參閱掃描程式碼變更以檢查安全性。

    相關應用案例