Viết báo cáo lỗ hổng

Sử dụng $codex-security:vulnerability-writeup để tạo một báo cáo độc lập cho từng lỗ hổng riêng biệt. Bạn có thể bắt đầu từ kết quả quét Codex Security hoặc trực tiếp sử dụng các phát hiện, ghi chú công bố, PoC và mã nguồn được cung cấp. Không bắt buộc phải có bản quét Codex Security.

Chuẩn bị bằng chứng

Cung cấp cho quy trình:

• Các phát hiện, ghi chú công bố lỗ hổng hoặc tài liệu đánh giá cần xem xét.
• Cây mã nguồn mục tiêu và bản sửa đổi hoặc bản phát hành bị ảnh hưởng.
• PoC, nhật ký, dấu vết thực thi, ảnh chụp màn hình hoặc đầu ra chẩn đoán hiện có.
• Các commit hoặc bản diff khắc phục nếu có.

Codex đối chiếu từng nhận định với mã nguồn bị ảnh hưởng trước khi viết báo cáo. Nếu không có mã nguồn hoặc bản sửa đổi bị ảnh hưởng, hãy quyết định có tiếp tục lập báo cáo nêu rõ các nhận định chưa được xác minh hay không.

Chạy quy trình

Gửi một câu lệnh như sau:

Use $codex-security:vulnerability-writeup to create one self-contained report for each distinct vulnerability in [input paths]. Verify the claims against [source path and revision], preserve or improve the supplied PoCs, and write the reports to [output directory]. Use a local test environment for reproductions.

Codex kiểm kê tài liệu được cung cấp, nhóm các báo cáo mô tả cùng nguyên nhân gốc rễ và đường thực thi có lỗ hổng, rồi tạo một thư mục báo cáo cho mỗi lỗ hổng riêng biệt. Mỗi thư mục chứa một báo cáo Markdown và một thư mục poc/ nếu có các tệp PoC hỗ trợ.

Xem xét từng báo cáo

Trước khi phân phối báo cáo, hãy xác nhận rằng báo cáo:

• Truy vết lỗi từ điểm vào do kẻ tấn công kiểm soát đến bất biến bảo mật bị vi phạm và tác động.
• Phân biệt hành vi đã xác minh với giả thuyết và các ràng buộc chưa được giải quyết.
• Bao gồm các trích đoạn mã nguồn cùng đường dẫn, hàm và bản sửa đổi bị ảnh hưởng.
• Bao gồm mã nguồn PoC, hướng dẫn biên dịch hoặc chạy, đầu ra tiêu biểu và các giới hạn về an toàn khi việc tạo PoC là khả thi.
• Sử dụng đường dẫn có thể dùng trên các môi trường khác nhau và không phụ thuộc vào bộ nhớ lưu trữ nội bộ hoặc đường dẫn tuyệt đối cục bộ.

Sử dụng báo cáo từ một bản quét

Báo cáo lỗ hổng chi tiết là tùy chọn đối với các lượt quét tiêu chuẩn, chuyên sâu và thay đổi. Khi bạn yêu cầu, Codex ghi từng báo cáo vào findings/<slug>/<slug>.md, lưu các tệp hỗ trợ trong findings/<slug>/poc/ và liên kết đến báo cáo từ report.md.

Hãy giữ toàn bộ thư mục quét cùng nhau khi chia sẻ hoặc lưu trữ một bản quét. Để tìm các cải tiến xử lý những mẫu vấn đề xuất hiện xuyên suốt các báo cáo, hãy tiếp tục với Đề xuất gia cố bảo mật.