Menjalankan pemindaian keamanan mendalam

Jalankan peninjauan keamanan berulang terhadap repositori atau folder dan tetapkan batas konkurensi serta durasi.

Pemindaian mendalam menjalankan beberapa pemindaian standar yang independen terhadap repositori atau folder yang sama dan menggabungkan temuannya. Gunakan saat Anda menginginkan peninjauan berulang dan dapat mengalokasikan waktu eksekusi serta penggunaan token tambahan.

Mulailah dengan pemindaian standar untuk memastikan bahwa cakupan dan konteks keamanan sesuai dengan tujuan Anda. Peninjauan berulang dapat menemukan masalah yang terlewat dalam peninjauan sebelumnya, tetapi tidak menjamin deteksi menyeluruh atau hasil yang identik antarproses pemindaian.

Pilih antara pemindaian standar dan mendalam

Pemindaian standar Pemindaian mendalam
Peninjauan Satu pemindaian standar Beberapa pemindaian standar dengan temuan yang digabungkan
Gunakan untuk Pemindaian pertama atau peninjauan dengan cakupan yang ditentukan Peninjauan independen tambahan atas cakupan tersebut
Cakupan Repositori atau folder Repositori atau folder
Perubahan Gunakan alur kerja peninjauan perubahan Tidak didukung

Mulai pemindaian mendalam

Untuk kualitas pemindaian terbaik, gunakan gpt-5.6-sol dengan tingkat upaya penalaran xhigh.

  1. Buka Security > Pemindaian lalu pilih + Pemindaian.
  2. Pilih repositori atau folder, pilih Basis kode, lalu aktifkan Pemindaian mendalam. Pemindaian meninjau seluruh repositori atau folder yang dipilih.
  3. Pilih model dan tingkat upaya penalaran. Tambahkan konteks model ancaman atau penerapan di Konteks tambahan.
  4. Pilih Mulai pemindaian.

Anda juga dapat memulainya dari percakapan Codex:

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

Untuk satu komponen, ganti "this repository" dengan jalur folder komponen tersebut.

Worker pemindaian mendalam mewarisi pengaturan model dan penalaran yang Anda pilih. Setiap worker menjalankan pemindaian standar secara lengkap, dan Codex Security menggabungkan hasil yang telah selesai. Pantau pemindaian tersimpan melalui Pemindaian, atau pilih Lihat aktivitas untuk memeriksa tugas Codex terkait. Tetapkan batas waktu proses sebelum memulai jika Anda perlu membatasi konkurensi atau durasi.

Pantau tahap pemindaian mendalam yang aktif dan periksa aktivitas Codex terkait sebelum meninjau hasil yang telah selesai.

Tinjau hasilnya

Pemindaian mendalam menggunakan detail pemindaian tersimpan dan direktori pemindaian lengkap yang sama dengan pemindaian standar. Buka pemindaian yang telah selesai di Pemindaian atau tinjau temuannya di Temuan. report.md yang dihasilkan menautkan ke laporan kerentanan terperinci atau panduan penguatan struktural saat Anda meminta keluaran tersebut. Sertakan direktori findings/ dan hardening/ yang tertaut bersama laporan saat membagikan atau mengarsipkan hasilnya.

Tinjau ringkasan cakupan sebelum temuan. Pemindaian mendalam pun memiliki keterbatasan, jadi periksa area yang ditangguhkan dan kesenjangan pembuktian yang tersisa sebelum menarik kesimpulan. Untuk temuan yang Anda terima, lanjutkan ke Perbaiki dan verifikasi temuan.

Untuk meninjau pull request, commit, rentang cabang, atau patch lokal, gunakan Tinjau perubahan kode. Pemindaian mendalam tidak menerima target diff.

Konfigurasikan waktu eksekusi pemindaian mendalam

Untuk mengontrol konkurensi dan durasi pemindaian mendalam, buat atau edit ~/.codex/codex-security/config.toml. Jika Anda menetapkan CODEX_HOME, gunakan $CODEX_HOME/codex-security/config.toml sebagai gantinya.

Sebagai contoh, profil ini menjalankan pemindaian yang lebih singkat dengan konkurensi terbatas:

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5
Pengaturan Default Deskripsi
workers 4 Jumlah worker pemindaian standar independen yang diizinkan berjalan secara bersamaan. Nilai lama "auto" juga ditetapkan menjadi 4.
subagents 3 Jumlah subagen yang dapat dimulai oleh setiap worker. Tetapkan 0 untuk menonaktifkannya.
stop_after_no_new 4 Hentikan setelah pemindaian worker selesai berturut-turut sebanyak ini tanpa menghasilkan temuan baru.
stop_after_consecutive_errors 3 Hentikan setelah terjadi kesalahan worker berturut-turut sebanyak ini.
max_discovery_runs 40 Batasi jumlah pemindaian standar independen yang dijalankan sebelum agregasi.
max_time_hours 96 Batasi eksekusi worker hingga sejumlah jam positif, maksimum 96; gunakan pecahan jika diperlukan.

Nilai yang lebih rendah dapat mengurangi waktu pemindaian dan penggunaan token, tetapi mungkin melewatkan temuan. Perubahan konfigurasi berlaku untuk pemindaian mendalam baru, bukan pemindaian yang sedang berlangsung.

Saat batas waktu berakhir, Codex Security menghentikan worker yang belum selesai, mempertahankan hasil pemindaian yang telah selesai, dan mengagregasikannya ke dalam laporan akhir. Jika tidak ada worker yang menyelesaikan peninjauan sumber sebelum tenggat, laporan akan mencatat cakupan parsial.

Pengaturan max_time_hours memerlukan plugin versi 0.1.19 atau yang lebih baru. Lihat log perubahan plugin untuk detail rilis.