GitHub code scanning içindeki AI Scan for repositories özelliği artık REST API üzerinden açılıp kapatılabiliyor. Public preview aşamasındaki değişiklik, mevcut AI Scan etkinleştirme uç noktalarına repository_scan adında yeni bir ayar ekliyor. Depo taramasını organizasyon ya da repo ayarlarına tek tek girerek açmak yerine script’lerle veya altyapıyı kod olarak yöneten araçlarla toplu biçimde dağıtmak mümkün hale geliyor.
Yeni repository_scan ayarı ne yapıyor?
Ayarı enabled veya disabled değerine çekmek için AI Scan etkinleştirme uç noktaları kullanılıyor, mantık hem organizasyon hem de repo düzeyinde aynı:
GETvePATCH /orgs/{org}/code-scanning/ai-scanGETvePATCH /repos/{owner}/{repo}/code-scanning/ai-scan
Tasarım, AI Scan for pull requests için zaten var olan pr_scan ayarının davranışını birebir taklit ediyor. PR taramasını API üzerinden yönetmek için daha önce bir otomasyon yazıldıysa aynı kalıp depo taraması için tekrar kullanılabiliyor, öğrenilecek yeni bir model yok.
Kalıtım ve engelleme kuralları
Ayarın organizasyon ile repo arasındaki ilişkisi net kurallara bağlı, bunları bilmeden yazılan otomasyon da beklenmedik hata yanıtlarıyla karşılaşabiliyor:
- Bir organizasyon AI Scan for repositories özelliğini devre dışı bırakırsa, o organizasyona bağlı depolar bu özelliği kendi başına etkinleştiremez.
- Organizasyon özelliği etkinleştirirse, depolar bu ayarı devralır; ancak isteyen depo tek tek kapsam dışına çıkabilir (opt out).
- Enterprise politikası AI Scan kullanımına izin vermiyorsa, etkinleştirme istekleri
422hatasıyla döner.
Hiyerarşi yukarıdan aşağı çalışıyor. Enterprise politikası en üstte kapı bekçisi, organizasyon ayarı ortada varsayılanı belirliyor, depo yöneticisi ise yalnızca aşağı yönde, yani kapatma yönünde hareket edebiliyor.
Tek istekte iki ayarı güncellemek
pr_scan ve repository_scan alanları aynı istek içinde birlikte güncellenebiliyor, ama davranış atomik. Değişikliklerden herhangi biri engellenirse istek 422 hatası dönduruyor ve iki ayar da değişmiyor. Kısmi uygulama yok. Otomasyon tarafında bu aslında iyi haber, yarı uygulanmış tutarsız bir durumla uğraşmak yerine isteği yeniden değerlendirip tekrar göndermek yetiyor.
Buna karşılık toplu dağıtım script’lerinde hata yanıtlarını sessizce yutmamak gerekiyor. Enterprise politikası kaynaklı bir 422 “ayar uygulandı” sanılırsa, envanterde gerçekte kapalı olan depolar açık görünür.
Açmak taramayı başlatmaz
AI Scan for repositories özelliğini etkinleştirmek kendiliğinden bir tarama başlatmıyor; ayar yalnızca yeteneği kullanılabilir hale getiriyor. Taramaları, yazma (write) erişimi olan kullanıcılar talep üzerine çalıştırmaya devam ediyor ve her tarama GitHub Code Security AI kredisi tüketiyor.
Maliyet planlamasında akılda tutulması gereken nokta da burası. Organizasyon genelinde ayarı açmak tek başına kredi tüketimi yaratmıyor, tüketim fiilen çalıştırılan taramalara bağlı. Geniş kapsamlı bir etkinleştirmeyle fiili kullanım hacmi arasındaki ilişkiyi ayrı ayrı izlemek gerekiyor.
Kimler yönetebilir, nerede çalışır?
Yetkiler ve kapsam kaynakta şöyle tanımlanıyor:
- Organizasyon sahipleri ve security manager rolündekiler organizasyon düzeyindeki ayarı yönetebilir.
- Depo yöneticileri tek tek depoları kapsam dışına çıkarabilir.
- Enterprise sahipleri önce enterprise politikasında AI Scan kullanımına izin vermelidir; aksi halde alt seviyelerdeki etkinleştirme denemeleri hata döner.
Depo kapsamı açısından AI Scan for repositories, organizasyonlara ait public depolarda kullanılabiliyor. GitHub Code Security veya GitHub Advanced Security bulunan private ve internal depolar da kapsamda. GitHub Enterprise Server desteklenmiyor, yani kendi sunucunuzda barındırdığınız kurulumlar bu API davranışının dışında kalıyor.
Uygulamaya geçerken ne yapmalı?
Özelliği kademeli yaymak isteyen ekipler için mantıklı sıra, kaynaktaki kurallardan doğrudan çıkıyor. Önce enterprise politikasının AI Scan’e izin verdiğini doğrulamak gerekiyor, bu adım atlandığında alttaki bütün istekler 422 ile sonuçlanıyor. Sonrasında organizasyon düzeyindeki repository_scan değeri belirleniyor, kapsam dışında kalması gereken depolar repo düzeyinde kapatılıyor.
Mevcut durumu görmek için GET uç noktaları kullanılabilir, değişiklik uygulanmadan önce organizasyon ve depo seviyesindeki değerler karşılaştırılabilir. Infrastructure as code yaklaşımıyla çalışan ekipler böylece ayarın arzu edilen durumunu (desired state) tanımlayıp düzenli olarak doğrulayabiliyor. Manuel, tek tek yapılan ayar değişikliklerinin yerini tekrarlanabilir ve denetlenebilir bir süreç alıyor.
Özellik public preview aşamasında olduğu için davranışın ileride değişebileceğini varsayıp otomasyonları esnek tutmak makul bir yaklaşım. Geri bildirim ve soru paylaşmak isteyenler için GitHub Community tartışma başlığı açık durumda.
Kaynaklar ve İleri Okuma
- Manage AI Scan for repositories using the REST API — The GitHub Blog changelog
- REST API endpoints for code scanning — GitHub Docs
- AI Scan for a repository’s backlog — GitHub Docs
- GitHub Community tartışma başlığı
- AI Scan, CodeQL’in Kapsamadığı Dilleri PR’da Tarıyor
- Dependabot Alerts REST API Artık Sürüm Bilgisi Veriyor
- GitHub Advanced Security’de Bütçe Sınırı: Kontrol Artık Sıkı
Bu içerik işinize yaradı mı?
Benzer içerikleri kaçırmamak için YouTube ve GitHub hesaplarımı takip edin.





Tam zamanında denk geldi bu yazı, biz de şirkette onlarca repo için code scanning ayarlarını tek tek elle yapıyorduk. repository_scan ayarını API ile toplu çekmeyi deneyeceğim, umarım org seviyesinde policy’lere takılmaz. pr_scan ile aynı mantıkta çalışması da işleri kolaylaştırır.
Bu yaklaşımın performans etkisini merak ediyorum, test ettiniz mi?
Konuyu bu açıdan hiç düşünmemiştim, perspektif değiştirdi.