Codex Security taraması çalıştırma

Bir depoyu veya seçilen bir klasörü incelemek için standart tarama kullanın. Bu kılavuz, kapsamı ayarlamayı, güvenlik bağlamı sağlamayı ve sonucu değerlendirmeyi açıklar. Eklentiyi henüz yüklemediyseniz eklenti hızlı başlangıç kılavuzuyla başlayın.

Aynı kapsamın tekrarlı incelemeleri için derin tarama kullanın. Bir pull request veya yerel diff için kod değişikliklerini inceleyin.

Tarama alanını seçin

Masaüstü uygulamasında Security bölümünü açın, Scans seçeneğini ve ardından + Scan seçeneğini belirleyin. Mevcut bir depoyu veya başka bir klasörü seçin, ardından Codebase seçeneğini belirleyin.

Geniş kapsam gerektiğinde ve depo makul bir inceleme birimi oluşturduğunda deponun tamamını tarayın. Bir monorepo'da hizmetin, paketin veya bileşenin belirli bir sorumlusu ve güvenlik sınırı varsa tek bir klasör seçin.

Bir Codex sohbetinden de tarama başlatabilirsiniz:

Use $codex-security:security-scan to scan this repository for security vulnerabilities.

Bu sohbeti belirli bir klasöre odaklamak için bileşeni belirtin:

Use $codex-security:security-scan to scan only services/billing in this repository for security vulnerabilities.

Taramayı yapılandırın

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

1. Codebase seçeneğini seçin ve Deep scan seçeneğini kapalı bırakın.
2. Seçili depoyu, geçerli dalı ve en son revizyonu doğrulayın.
3. Scan area alanını deponun tamamı olarak ayarlayın veya bir klasör seçin.
4. Bir model ve akıl yürütme düzeyi seçin.
5. Saldırganın denetimindeki girdileri, güven sınırlarını, hassas işlemleri veya öncelik verilecek bir alanı açıklamak için Additional context alanını kullanın.
6. Start scan seçeneğini seçin.

Kalıcı güvenlik rehberliği için depo köküne SECURITY.md ekleyin. Tehdit modelini, güvenlik değişmezlerini, raporlanabilir bulgu ölçütlerini, hariç tutulanları ve önem derecesi bağlamını açıklayın. Dizine özgü rehberlik için iç içe dizinlere SECURITY.md dosyaları ekleyin. İlkeler çakıştığında koda en yakın dosya önceliklidir. Codex Security bu dosyaları yürütülebilir talimatlar olarak değil, ilke bağlamı olarak değerlendirir.

Desteklenen derleme ve doğrulama komutlarıyla depoya özgü diğer talimatlar için AGENTS.md kullanın.

Tarama ilerlemesini takip edin

Çalışma alanı, geçerli aşamayı ve bildirilen ilerlemeyi gösterir. Codex görevini incelemek için View activity seçeneğini seçin. Codex kanıtları kontrol ederken bulgular değişebileceğinden, tarama tamamlandıktan sonra nihai sonucu inceleyin.

Tamamlanan taramayı inceleyin

Sonucu şu sırayla inceleyin:

1. Hedefi, revizyonu ve tarama alanını doğrulayın.
2. İncelenen yüzeyleri ve ertelenen veya takip gerektiren alanları okuyun.
3. Her bulgu için saldırganın etkilenen koda nasıl ulaştığını, hangi kontrolün başarısız olduğunu ve kanıtların hangi etkiyi desteklediğini kontrol edin. Doğrulama yöntemini ve yanıtlanmamış soruları okuyun.
4. Kanıtı eksik olan bulguları araştırın. Bir bulgunun neden geçerli olmadığını açıklayabiliyorsanız bulguyu reddedin ve bu açıklamayı sonuçla birlikte saklayın.
5. Bir düzeltmeye başlamadan önce kabul edilmiş bir bulgu seçin.

Taramanın tamamlanması ve kapsamın eksiksiz olması ayrı iddialardır. Tarama başarıyla sonuçlansa bile ertelenen alanları okuyun. Kaynak koda dayalı doğrulama, çalışma zamanında yeniden üretim olmadan da bir bulguyu destekleyebilir. Kodu çalıştırmaya bağlı belirsizliği gidermek için ilgili bulgunun doğrulanmasını isteyin.

İlk taramanızı karşılaştırma temeli olarak kullanın

Taramadan önce kanıt kalitesi veya yanlış pozitifler gibi neleri karşılaştırmak istediğinize karar verin. Bilinen bir bulguyla sınama yapıyorsanız bu bulguyu Codex'e verip vermediğinizi veya taramadan gizleyip gizlemediğinizi kaydedin.

Depo revizyonunu, eklenti sürümünü, modeli ve akıl yürütme düzeyini kaydedin. Kod, güvenlik denetimleri veya tarama ayarları değiştikten sonraki taramaları karşılaştırmak için bu temel çizgiyi kullanın.

Önceki bir taramayı yeniden açın

Bulgularını, kapsamını ve mevcut rapor çıktılarını incelemek için Security bölümünü açın, ardından Scans bölümünden kayıtlı bir tarama seçin. En güncel kodu değerlendirmek için aynı depoda yeni bir tarama başlatın. Yeni tarama, önceki taramanın veya çıktılarının yerini almaz.

Sonuçları kullanın

Taşınabilir bir rapor için report.md dosyasını açın ve paylaşırken veya arşivlerken tarama dizininin bütünlüğünü koruyun. Diğer biçimler veya sorun takibi için Bulguları dışa aktarın ve takip edin bölümünü kullanın. Bir bulguyu kabul ettikten sonra bir düzeltme oluşturun ve doğrulayın.