Menulis laporan kerentanan

Gunakan $codex-security:vulnerability-writeup untuk membuat laporan mandiri bagi setiap kerentanan yang berbeda. Anda dapat memulai dari hasil pemindaian Codex Security atau langsung menggunakan temuan, catatan pengungkapan, PoC, dan kode sumber yang disediakan. Pemindaian Codex Security tidak diwajibkan.

Menyiapkan bukti

Berikan hal-hal berikut kepada alur kerja:

• Temuan, catatan pengungkapan, atau dokumen penilaian yang akan ditinjau.
• Pohon kode sumber target dan revisi atau rilis yang terdampak.
• PoC, log, jejak eksekusi, tangkapan layar, atau keluaran diagnostik yang tersedia.
• Commit atau diff perbaikan jika tersedia.

Codex memeriksa setiap klaim terhadap kode sumber yang terdampak sebelum menulis laporan. Jika kode sumber atau revisi yang terdampak tidak tersedia, tentukan apakah akan melanjutkan dengan laporan yang mengidentifikasi klaim yang belum diverifikasi.

Menjalankan alur kerja

Kirim prompt seperti:

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 menginventarisasi materi yang diberikan, mengelompokkan laporan yang menjelaskan akar penyebab dan jalur rentan yang sama, serta membuat satu direktori laporan untuk setiap kerentanan yang berbeda. Setiap direktori berisi laporan Markdown dan direktori poc/ jika berkas PoC pendukung tersedia.

Meninjau setiap laporan

Sebelum mendistribusikan laporan, pastikan laporan tersebut:

• Menelusuri bug dari titik masuk yang dikendalikan penyerang hingga invarian keamanan yang dilanggar dan dampaknya.
• Membedakan perilaku yang terverifikasi dari hipotesis dan kendala yang belum terselesaikan.
• Menyertakan cuplikan kode sumber beserta jalur, fungsi, dan revisi yang terdampak.
• Menyertakan kode sumber PoC, petunjuk build atau eksekusi, contoh keluaran yang representatif, dan batasan keselamatan jika PoC dapat dibuat secara praktis.
• Menggunakan jalur portabel dan tidak bergantung pada penyimpanan internal atau jalur absolut lokal.

Menggunakan laporan dari pemindaian

Laporan kerentanan terperinci bersifat opsional untuk pemindaian standar, mendalam, dan perubahan. Saat Anda memintanya, Codex menulis setiap laporan ke findings/<slug>/<slug>.md, menyimpan file pendukung di bawah findings/<slug>/poc/, dan menautkan laporan dari report.md.

Pertahankan seluruh direktori pemindaian tetap bersama saat membagikan atau mengarsipkan pemindaian. Untuk mencari peningkatan yang menangani pola di berbagai laporan, lanjutkan dengan Mengusulkan penguatan keamanan.