Derin güvenlik taraması çalıştırma

Bir depo veya klasör üzerinde tekrarlanan güvenlik incelemeleri yürütün ve eşzamanlılık ile süre sınırlarını belirleyin.

Derin tarama, aynı depo veya klasör üzerinde birbirinden bağımsız birden fazla standart tarama çalıştırır ve bulgularını birleştirir. Tekrarlanan inceleme istediğinizde ve ek çalışma süresine ve token kullanımına ayıracak kaynağınız olduğunda kullanın.

Kapsamın ve güvenlik bağlamının hedefinize uygun olduğunu kontrol etmek için bir standart taramayla başlayın. Tekrarlanan inceleme, önceki incelemede kaçırılan sorunları bulabilir ancak tüm sorunların tespit edilmesini veya çalıştırmalar arasında aynı sonuçların elde edilmesini garanti etmez.

Standart ve derin taramalar arasında seçim yapın

Standart tarama Derin tarama
İnceleme Bir standart tarama Bulguları birleştirilen birden fazla standart tarama
Kullanım amacı İlk tarama veya belirli bir kapsamın incelenmesi Aynı kapsam üzerinde ek bağımsız incelemeler
Kapsam Depo veya klasör Depo veya klasör
Değişiklikler Değişiklik inceleme iş akışını kullanın Desteklenmez

Derin taramayı başlatın

En iyi tarama kalitesi için gpt-5.6-sol modelini xhigh akıl yürütme düzeyiyle kullanın.

  1. Security > Scans bölümünü açın ve + Scan seçeneğini seçin.
  2. Bir depo veya klasör seçin, Codebase seçeneğini seçin ve Deep scan seçeneğini açın. Tarama, seçili deponun veya klasörün tamamını inceler.
  3. Modeli ve akıl yürütme düzeyini seçin. Additional context alanına tehdit modeli veya dağıtım bağlamı ekleyin.
  4. Start scan seçeneğini seçin.

Taramayı bir Codex görüşmesinden de başlatabilirsiniz:

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

Tek bir bileşen için "this repository" ifadesini bileşenin klasör yoluyla değiştirin.

Derin tarama çalışanları, seçtiğiniz model ve akıl yürütme ayarlarını devralır. Her çalışan eksiksiz bir standart tarama yürütür ve Codex Security tamamlanan sonuçları bir araya getirir. Kayıtlı taramayı Scans bölümünden takip edin veya Codex görevini incelemek için View activity seçeneğini seçin. Eşzamanlılığı veya süreyi sınırlamanız gerekiyorsa başlamadan önce çalışma sınırlarını ayarlayın.

Tamamlanan sonucu incelemeden önce etkin derin tarama aşamasını takip edin ve Codex etkinliğini inceleyin.

Sonucu inceleyin

Derin taramalar, standart taramalarla aynı kayıtlı tarama ayrıntılarını ve eksiksiz tarama dizinini kullanır. Tamamlanan taramayı Scans bölümünde açın veya bulgularını Findings bölümünde inceleyin. Oluşturulan report.md, bu çıktıları istediğinizde ayrıntılı güvenlik açığı raporlarına veya yapısal sağlamlaştırma rehberine bağlantılar içerir. Sonucu paylaşırken veya arşivlerken bağlantı verilen findings/ ve hardening/ dizinlerini raporla birlikte saklayın.

Bulgulardan önce kapsam özetini inceleyin. Derin taramanın da sınırları vardır; bu nedenle bir sonuca varmadan önce ertelenen yüzeyleri ve kalan kanıt eksiklerini kontrol edin. Kabul ettiğiniz bir bulgu için Bir bulguyu düzeltin ve doğrulayın bölümüyle devam edin.

Bir çekme isteğini, commit'i, dal aralığını veya yerel yamayı incelemek için Kod değişikliklerini inceleyin bölümünü kullanın. Derin taramalar diff hedeflerini kabul etmez.

Derin taramanın çalışma süresini yapılandırın

Derin taramanın eşzamanlılığını ve süresini kontrol etmek için ~/.codex/codex-security/config.toml dosyasını oluşturun veya düzenleyin. CODEX_HOME ayarlarsanız bunun yerine $CODEX_HOME/codex-security/config.toml kullanın.

Örneğin bu profil, sınırlı eşzamanlılıkla daha kısa bir tarama çalıştırır:

[deep_scan]
workers = 2
subagents = 0
stop_after_no_new = 3
max_discovery_runs = 10
max_time_hours = 1.5
Ayar Varsayılan Açıklama
workers 4 Aynı anda çalışmasına izin verilen bağımsız standart tarama çalışanı sayısı. Eski "auto" değeri de 4 olarak çözümlenir.
subagents 3 Her çalışanın başlatabileceği alt ajan sayısı. Bunları devre dışı bırakmak için 0 olarak ayarlayın.
stop_after_no_new 4 Art arda tamamlanan bu sayıda çalışan taraması yeni bulgu üretmezse durdurulur.
stop_after_consecutive_errors 3 Art arda bu sayıda çalışan hatası oluşursa durdurulur.
max_discovery_runs 40 Toplama öncesindeki bağımsız standart tarama çalıştırmalarının sayısını sınırlar.
max_time_hours 96 Çalışan yürütmesini 96 değerine kadar pozitif bir saat sayısıyla sınırlar; gerektiğinde kesirli değerler kullanın.

Daha düşük değerler tarama süresini ve token kullanımını azaltabilir ancak bazı bulgular gözden kaçabilir. Yapılandırma değişiklikleri, hâlihazırda devam eden taramalara değil yeni derin taramalara uygulanır.

Süre sınırı dolduğunda Codex Security tamamlanmamış çalışanları durdurur, tamamlanan tarama sonuçlarını korur ve bunları nihai raporda toplar. Son tarihten önce hiçbir çalışan kaynak incelemesini tamamlamazsa rapor, kapsamın kısmi olduğunu kaydeder.

max_time_hours ayarı, 0.1.19 veya sonraki bir eklenti sürümünü gerektirir. Sürüm ayrıntıları için eklenti değişiklik günlüğüne bakın.