Güvenlik bulgularını düzeltme ve doğrulama

Kanıtlarını kabul ettiğiniz tek bir bulguyla başlayın. Bir yama oluşturun, inceleyin ve asıl sorunu değiştirilmiş kod üzerinde doğrulayın. Oluşturulan veya uygulanan bir yama henüz doğrulanmış bir düzeltme değildir.

Masaüstü çalışma alanında yama oluşturma işlemi seçili çalışma kopyasını değiştirmez. Yamayı uygulamak bu çalışma kopyasını değiştirir. Doğrulama, bulguyu otomatik olarak kapatmadan yamayı kontrol eder ve kanıtları kaydeder.

Kullanıcı arayüzünde bir bulguyu düzeltme

Findings bölümünden veya Scans bölümündeki tamamlanmış bir taramadan kabul edilmiş bir bulguyu açın. Kanıtlarını inceleyin, ardından bir düzeltme oluşturmak, incelemek, uygulamak ve doğrulamak için Patch seçeneğini kullanın.

1. Bir yama oluşturun

   Bulguyu açın, Patch sekmesini ve ardından Generate patch öğesini seçin. Codex mümkün olduğunda sorunu doğrular veya yeniden üretir ve seçili checkout'u değiştirmeden bir yama yapıtı yazar.

2. Önerilen diff'i inceleme

   Etkilenen kodu ve testleri kontrol edin. Değişikliğin, ilgisiz yeniden düzenlemeler yapmadan veya güvenlik denetimlerini zayıflatmadan bulguyu giderdiğini doğrulayın.

3. Yamayı yerel olarak uygulama

   Farkı yalnızca kabul edilebilir bulduktan sonra Apply patch seçeneğini belirleyin. Codex, oluşturulan yamayı aynen worktree'ye uygular ve bu durumu kaydeder. Devam etmeden önce worktree'deki farkı inceleyin.

4. Düzeltmeyi doğrulama

   Verify fix seçeneğini belirleyin. Codex, sorunu yeniden üreten özgün kodu veya başka bir istismar kontrolünü yeniden çalıştırır. Bir regresyon testi çalıştırabildiğinde, testin düzeltmeden önce başarısız, düzeltmeden sonra başarılı olduğunu kontrol eder. Aksi durumda, doğrulama eksikliğini ve tamamlayabildiği kontrolleri kaydeder. Ayrıca meşru davranışları, benzer atlatma yollarını ve depo testlerini kontrol eder.

5. Bulguyu kapatın

   Doğrulama, bir bulguyu otomatik olarak kapatmaz. Komutları, sonuçları ve kalan kanıt boşluğunu inceleyin; ardından bulguyu doğru bir gerekçeyle kapatın veya daha fazla çalışma için açık tutun.

Bir konuşmada bulguyu düzeltin

Yüklü eklentiyi bir taramadan, kayıttan, güvenlik duyurusundan veya başka bir incelemeden gelen bulguyla kullanın. Bulgu kimliğini ve rapor yolunu, varsa sorunu yeniden üreten kodu veya doğrulama komutunu sağlayın:

Use $codex-security:fix-finding to fix finding <finding-id> from <report-path>. Verify the issue against this checkout, fix it, and test the original failure and legitimate behavior. Record any verification you couldn't complete.

Bu, çalışma kopyasında düzenleme yapılmasına izin verir. Codex, eksik teknik ayrıntılar için depoyu inceleyebilir ancak bir düzeltme seçmeden önce amaçlanan güvenlik politikasını netleştirmenizi isteyebilir.

Giderme işlemini etkileşim olmadan çalıştırın

Tekrarlanabilir taramalar ve yama oluşturma için bağımsız CLI'ın doğrulama ve yama komutlarını kullanın.

Yüklü eklentiyi Codex CLI üzerinden çağırmak için önce Codex Security'yi çalıştırıcının CODEX_HOME dizinine yükleyin. Yeni bir çalıştırıcı varsayılan olarak mağaza eklentilerini içermez. Kabul edilmiş her bulgu için ayrı bir çalışma kopyası veya iş kullanın:

codex exec --sandbox workspace-write 'Use $codex-security:fix-finding to fix finding <finding-id> from <report-path>. Verify the issue against this checkout, fix it, and test the original failure and legitimate behavior. Record any verification you could not complete.'

Yazılabilir korumalı alan, iş akışının kaynak kodunu ve testleri düzenlemesine izin verir. Yamayı ve doğrulama kanıtlarını inceleme için saklayın. Kurulum, tarama yapılandırması ve çıktı dosyalarının yönetimi için CI/CD'de incelemeleri otomatikleştirme bölümüne bakın.

Doğrulamadan sonra değişikliği normal kod inceleme sürecinizle birleştirin. Doğrulama tamamlanmadıysa kalan işleri belirterek bulguyu açık tutun.