AI CodeOps

Git'e bir secret commit edildiğinde ne yapmalı

Son güncelleme

Bir Git reposuna commit edilen bir kimlik bilgisine adım adım müdahale: önce iptal edip yenileyin, kötüye kullanımı kontrol edin, geçmişi temizleyin ve tekrarını önleyin.

Bir API anahtarı, token, parola veya özel anahtar gibi bir secret bir Git reposuna commit edildiğinde önce onu iptal edin ve yenileyin, ardından neye erişebileceğini ve kullanılıp kullanılmadığını belirleyin, sonra onu koddan ve politikanız gerektiriyorsa geçmişten kaldırın. Satırı yeni bir commit'te silmek tek başına işe yaramaz: Git önceki her sürümü saklar ve her klonun, fork'un ve CI önbelleğinin bir kopyası vardır. Kimlik bilgisini push edildiği andan itibaren ele geçirilmiş sayın.

Bu sayfa, Yapay zekânın ürettiği kod nasıl güvenli hâle getirilir? rehberinin secret taraması bölümünü genişletir.

Satırı silmek neden yeterli değildir

Bir Git reposu bir klasör değil, bir geçmiştir. Bir secret'ı yeni bir commit'te kaldırmak onu önceki commit'te bırakır; erişimi olan herkes onu tek bir komutla okuyabilir. Reponun dışında da kopyalar bulunur:

  • her geliştiricinin klonu ve her fork;
  • repoyu klonlamış CI sistemleri ve bunların önbellekleri ve günlükleri;
  • Git platformunun commit'e ve onu içeren her pull request'e dair kendi görünümleri;
  • o commit'ten oluşturulmuş container imajları veya build yapıtları;
  • yedekler ve aynalar (mirror).

Herkese açık repolar, kimlik bilgisi arayan otomatik araçlar tarafından sürekli taranır; bu yüzden herkese açık bir repo için secret'ın push edildiği anda görüldüğünü varsayın. Özel repolarda kitle daha küçüktür ama sıfır değildir.

Adım 1: iptal edin ve yenileyin

Sızan değeri işe yaramaz hâle getiren tek adım yenilemedir. Herhangi bir temizlikten önce ilk iş olarak yapın.

  1. Sağlayıcıda yerine geçecek bir kimlik bilgisi oluşturun.
  2. Yenisini, onu meşru olarak kullanan her yere dağıtın.
  3. Sızan kimlik bilgisini iptal edin; böylece artık çalışmaz.

Secret'ın etkisi yüksekse ve maruziyet herkese açıksa, yenisini dağıtırken çalışan bir kimlik bilgisini açıkta bırakmak yerine hemen iptal edin ve kısa bir kesintiyi kabul edin. Bazı sağlayıcılar kendi anahtarlarını herkese açık repolarda tespit edip otomatik olarak iptal eder; buna güvenmeyin.

Adım 2: kapsamı anlayın

Kimlik bilgisinin neler yapabileceğini yazın:

  • Neye yetki verdiği. Tek bir servise salt okunur erişim mi, yoksa bir bulut hesabına yönetici erişimi mi?
  • Başka nerede kullanıldığı. Paylaşılan kimlik bilgileri, yenilenecek daha fazla sistem demektir.
  • Ne zaman açığa çıktığı. Commit zamanı, incelenecek zaman aralığının başlangıcını belirler.
  • Kimin görebildiği. Herkese açık mı, tüm kuruluş mu, yoksa tek bir ekip mi? Fork'lar var mıydı?

Bu, olayın ne kadar inceleme gerektirdiğini ve kimin bilgilendirilmesi gerektiğini belirler.

Adım 3: kötüye kullanımı kontrol edin

Maruziyet aralığında o kimlik bilgisini kullanan etkinlik için sağlayıcının denetim veya erişim günlüklerine bakın: tanıdık olmayan IP adresleri, beklenmeyen bölgeler, yeni kaynaklar, olağandışı veri erişimi veya kullanım ve faturalandırmada ani artışlar. Kötüye kullanım bulursanız bu, kendi müdahalesi olan bir güvenlik olayına dönüşmüştür: sınırlayın, neye erişildiğini inceleyin ve politikalarınızın ve yükümlülüklerinizin gerektirdiği kişileri bilgilendirin.

Adım 4: kodu ve geçmişi temizleyin

Secret'ı güncel koddan kaldırın ve yerine değerin artık bulunduğu yere bir referans koyun: bir ortam değişkeni, bir secret yöneticisi veya commit edilmeyen bir yapılandırma dosyası.

Geçmişin de yeniden yazılıp yazılmayacağı politikanıza bağlıdır. Yeniden yazarsanız:

  • git filter-repo veya BFG Repo-Cleaner gibi bunun için yapılmış bir araç kullanın. Git projesi, eski git filter-branch yerine git filter-repo kullanılmasını önerir.
  • Repo üzerinde çalışan herkesle koordine olun. Yeniden yazma commit özetlerini (hash) değiştirir; bu yüzden mevcut klonların yeniden klonlanması veya dikkatle sıfırlanması gerekir.
  • Git platformunuzun neleri sakladığını kontrol edin. Pull request referansları ve önbelleğe alınmış görünümler eski commit'leri hâlâ gösterebilir; platform dokümantasyonu bunların nasıl kaldırılacağını açıklar.
  • Fork'ların ve klonların erişim dışında olduğunu unutmayın. Yenilemenin önce gelmesinin nedeni budur.

CI günlüklerini temizleyin ve secret'ı içeren yapıtları veya imajları yeniden oluşturun.

Adım 5: nedeni düzeltin

Secret'ın repoya nasıl girdiğini bulun ve bu yolu kapatın.

  • Secret'ları izlenen dosyaların dışında tutun. .env gibi yerel yapılandırma dosyaları, yer tutucu değerler içeren commit edilmiş bir örnek dosyayla birlikte .gitignore içine aittir.
  • Commit'ten önce tarayın. gitleaks, TruffleHog veya detect-secrets gibi bir secret tarayıcısı çalıştıran pre-commit hook'ları, hataların çoğunu geliştiricinin makinesinde yakalar.
  • Push sırasında tarayın. Bazı Git platformları, tanınan bir kimlik bilgisi içeren bir push'u reddeden push koruması sunar.
  • Geçmişi bir kez tarayın. Tüm geçmişin tek seferlik bir taraması, kimsenin fark etmediği eski sızıntıları bulur.
  • Kimlik bilgilerini build ve çalışma zamanında enjekte edin. Build ve dağıtım işleri, secret'ları bir secret yöneticisinden veya CI sisteminin secret deposundan, onlara ihtiyaç duyan işlerle sınırlı ve günlüklerde maskeli olarak alır.
  • Kısa ömürlü kimlik bilgilerini tercih edin. Sağlayıcıların desteklediği yerlerde iş yükü kimliği (workload identity) veya dakikalar içinde süresi dolan token'lar, herhangi bir sızıntının zararını sınırlar.

Adım 6: olanları kaydedin

Kısa bir kayıt yazın: ne sızdı, ne zaman, ne kadar süre açıkta kaldı, neye erişebiliyordu, kullanıldı mı, ne yenilendi ve tekrarı önlemek için ne değişti. Denetimler için faydalıdır ve aynı tür hatanın tekrarlanıp tekrarlanmadığını fark etmenin en iyi yoludur.

Secret'lar ve yapay zekâ kodlama ajanları

Yapay zekâ ajanları secret'ların sızması için yeni yollar ekler. Bir .env dosyasını okuyan bir ajan gerçek bir anahtarı koda, bir test fixture'ına veya bir yapılandırma örneğine kopyalayabilir. Prompt'unda veya bağlamında bir kimlik bilgisi verilen bir ajan onu çıktıya, günlüklere veya bir model sağlayıcısına gönderilen bir isteğe yazabilir. Ve sağlayıcı tarafındaki prompt günlükleri artık secret'ı da içerebilir; bu da yanıtın yine silmek değil, yenilemek olduğu anlamına gelir.

En etkili denetim basittir: kod yazan ajanların bağlamında asla canlı ortam kimlik bilgileri olmamalıdır. Secret'ları ajana değil, onlara ihtiyaç duyan build veya dağıtım işine verin.

AI CodeOps secret'ları nasıl ele alır

AI CodeOps repolarınızı secret'lar için taramaz; kendi pipeline'ınızda bir secret tarayıcısı kullanmaya devam edin. Yaptığı, çalışma alanı secret'larını yapay zekâ ajanlarından uzak tutmak ve nasıl yönetildiklerini kaydetmektir.

  • Şifreli ve maskeli. Çalışma alanı secret'ları depolanırken AES-256-GCM ile şifrelenir. Kaydettikten sonra konsol yalnızca bir maske gösterir.
  • Kapsamı sınırlı ve yenilenebilir. Bir secret belirli iş akışlarıyla sınırlandırılabilir, bir son kullanma tarihi verilebilir, devre dışı bırakılabilir veya yerinde yenilenebilir; yenileme zamanı ve sürümü kaydedilir.
  • Ajanlardan uzak. Secret'lar build işlerine ortam değişkenleri olarak ulaşır ve değerleri build günlüğünden çıkarılır. Yapay zekâ ajanları onları asla almaz.
  • Denetlenir. Bir secret'ın oluşturulması, güncellenmesi, açılıp kapatılması ve silinmesi denetim günlüğüne kaydedilir. Secret Manager rolü, başka hiçbir erişim olmadan secret'ları yönetebilir.
  • İncelenen değişiklikler. Her yapay zekâ değişikliğinin bulgu incelemesi güvenliği kapsar ve Security Auditor, onu içeren iş akışlarında açığa çıkmış secret'ları arar. Bir politika kuralı, config/secrets/** gibi yollardaki değişiklikleri reddedebilir.

Güvenlik ve SBOM sayfasına, secret taraması sözlük maddesine ve genel bakış için Güvenlik ve SBOM takibi sayfasına bakın.

Sık sorulan sorular

Secret'ı yeni bir commit'te silmek yeterli mi?

Hayır. Secret repo geçmişinde, her klonda ve fork'ta ve muhtemelen CI günlüklerinde ve önbelleklerinde kalır. Onu iptal edin ve yenileyin; koddan silmek daha sonraki bir temizlik adımıdır.

Bir secret sızdırdıktan sonra Git geçmişini yeniden yazmalı mıyım?

Yalnızca secret iptal edildikten sonra ve yalnızca politikanız gerektiriyorsa. Yeniden yazma mevcut klonlara ve fork'lara ulaşmaz ve repo üzerinde çalışan herkesi aksatır; bu yüzden asla yenilemenin yerini tutmaz.

Repo özelse ne olur?

Yine de yenileyin. Erişimi olan herkes, onu klonlayan her CI sistemi, her fork ve her yedek artık secret'ı tutuyor. Özel olması maruziyeti azaltır; ortadan kaldırmaz.

Secret'ların en baştan commit edilmesini nasıl önlerim?

Secret'ları commit edilen dosyaların dışında tutun, commit'ten önce bir pre-commit hook ile tarayın, Git platformunuz sunuyorsa push korumasını açın ve kimlik bilgilerini repoda saklamak yerine bir secret yöneticisinden build işlerine enjekte edin.