Chạy một lượt quét bảo mật sâu

Rà soát bảo mật lặp lại cho một kho mã hoặc thư mục và đặt giới hạn về số tác vụ đồng thời cũng như thời lượng.

Lượt quét chuyên sâu chạy nhiều lượt quét tiêu chuẩn độc lập trên cùng một kho mã hoặc thư mục rồi tổng hợp các phát hiện. Hãy dùng khi bạn muốn rà soát lặp lại và có thể dành thêm thời gian chạy cũng như lượng token sử dụng.

Bắt đầu với một lượt quét tiêu chuẩn để kiểm tra xem phạm vi và bối cảnh bảo mật có phù hợp với mục tiêu của bạn hay không. Rà soát lặp lại có thể tìm ra những vấn đề bị bỏ sót ở lần trước, nhưng không đảm bảo phát hiện đầy đủ hoặc cho kết quả giống nhau giữa các lần chạy.

Chọn giữa lượt quét tiêu chuẩn và lượt quét sâu

Quét tiêu chuẩn Quét chuyên sâu
Rà soát Một lượt quét tiêu chuẩn Nhiều lượt quét tiêu chuẩn với các phát hiện được tổng hợp
Dùng cho Lượt quét đầu tiên hoặc rà soát một phạm vi xác định Các lượt rà soát độc lập bổ sung cho phạm vi đó
Phạm vi Kho mã hoặc thư mục Kho mã hoặc thư mục
Thay đổi Dùng quy trình rà soát thay đổi Không được hỗ trợ

Bắt đầu lượt quét chuyên sâu

Để có chất lượng quét tốt nhất, hãy dùng gpt-5.6-sol với mức suy luận xhigh.

  1. Mở Bảo mật > Lượt quét và chọn + Quét.
  2. Chọn một kho mã hoặc thư mục, chọn Cơ sở mã và bật Quét chuyên sâu. Lượt quét rà soát toàn bộ kho mã hoặc thư mục đã chọn.
  3. Chọn mô hình và mức suy luận. Thêm bối cảnh về mô hình mối đe dọa hoặc triển khai trong Bối cảnh bổ sung.
  4. Chọn Bắt đầu quét.

Bạn cũng có thể bắt đầu từ một cuộc trò chuyện với Codex:

Use $codex-security:deep-security-scan to run a deep security scan of this repository.

Để quét một thành phần, hãy thay "this repository" bằng đường dẫn đến thư mục của thành phần đó.

Các worker quét chuyên sâu kế thừa mô hình và cài đặt suy luận bạn đã chọn. Mỗi worker chạy một lượt quét tiêu chuẩn đầy đủ, rồi Codex Security tổng hợp các kết quả đã hoàn tất. Theo dõi lượt quét đã lưu trong Lượt quét, hoặc chọn Xem hoạt động để kiểm tra tác vụ Codex tương ứng. Đặt giới hạn thời gian chạy trước khi bắt đầu nếu bạn cần giới hạn số tác vụ đồng thời hoặc thời lượng.

Theo dõi giai đoạn quét chuyên sâu đang diễn ra và kiểm tra hoạt động Codex tương ứng trước khi rà soát kết quả đã hoàn tất.

Rà soát kết quả

Quét chuyên sâu sử dụng cùng thông tin chi tiết lượt quét đã lưu và thư mục quét đầy đủ như quét tiêu chuẩn. Mở lượt quét đã hoàn tất trong Lượt quét hoặc rà soát các phát hiện trong Phát hiện. Tệp report.md được tạo liên kết đến các báo cáo lỗ hổng chi tiết hoặc hướng dẫn gia cố cấu trúc khi bạn yêu cầu những đầu ra đó. Giữ mọi thư mục findings/ và hardening/ được liên kết cùng với báo cáo khi chia sẻ hoặc lưu trữ kết quả.

Rà soát bản tóm tắt phạm vi bao phủ trước các phát hiện. Ngay cả quét chuyên sâu cũng có giới hạn, vì vậy hãy kiểm tra các bề mặt được hoãn xem xét và những khoảng trống bằng chứng còn lại trước khi đưa ra kết luận. Với một phát hiện bạn chấp nhận, hãy tiếp tục với Khắc phục và xác minh một phát hiện.

Để rà soát một pull request, commit, phạm vi nhánh hoặc bản vá cục bộ, hãy dùng Rà soát các thay đổi mã nguồn. Quét chuyên sâu không chấp nhận mục tiêu diff.

Cấu hình thời gian chạy của lượt quét sâu

Để kiểm soát mức độ đồng thời và thời lượng của một lượt quét sâu, hãy tạo hoặc chỉnh sửa ~/.codex/codex-security/config.toml. Nếu bạn đặt CODEX_HOME, hãy sử dụng $CODEX_HOME/codex-security/config.toml thay thế.

Ví dụ, hồ sơ này chạy một lượt quét ngắn hơn với mức độ đồng thời giới hạn:

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5
Cài đặt Mặc định Mô tả
workers 4 Số worker quét tiêu chuẩn độc lập được phép chạy cùng lúc. Giá trị cũ "auto" cũng được phân giải thành 4.
subagents 3 Số tác nhân phụ mà mỗi worker có thể khởi chạy. Đặt thành 0 để tắt chúng.
stop_after_no_new 4 Dừng sau khi số lượt quét worker liên tiếp đã hoàn tất này không tạo ra phát hiện mới.
stop_after_consecutive_errors 3 Dừng sau số lỗi worker liên tiếp này.
max_discovery_runs 40 Giới hạn số lượt chạy quét tiêu chuẩn độc lập trước khi tổng hợp.
max_time_hours 96 Giới hạn thời gian thực thi của worker ở một số giờ dương, tối đa 96; có thể dùng số thập phân nếu cần.

Giá trị thấp hơn có thể giảm thời gian quét và mức sử dụng token nhưng có thể bỏ sót phát hiện. Các thay đổi cấu hình áp dụng cho lượt quét sâu mới, không áp dụng cho lượt quét đang diễn ra.

Khi hết thời gian giới hạn, Codex Security dừng các worker chưa hoàn tất, giữ lại kết quả quét đã hoàn tất và tổng hợp chúng vào báo cáo cuối cùng. Nếu không có worker nào hoàn tất việc rà soát mã nguồn trước thời hạn, báo cáo sẽ ghi nhận phạm vi bao phủ một phần.

Cài đặt max_time_hours yêu cầu plugin phiên bản 0.1.19 trở lên. Xem nhật ký thay đổi của plugin để biết chi tiết về bản phát hành.