API anahtarı sızıntısı: kodda unutulan anahtarları bulma, iptal etme ve önleme
Hazırlayan Ersin DorlakYayın: Son güncelleme:
8 dk okuma
Kısa özetAPI anahtarı sızıntısı nasıl olur, depoda unutulan anahtar ve parolalar nasıl bulunur, iptal edilir ve yeniden sızması nasıl önlenir; adım adım rehber.
API anahtarı sızıntısı, bir hizmete erişim sağlayan anahtarın, jetonun ya da parolanın yetkisiz kişilerin görebileceği bir yere düşmesidir. En sık görülen yol basittir: geliştirici anahtarı denemek için koda yazar, sonra silmeyi unutur ve kod bir depoya gönderilir. Depo herkese açıksa anahtar dakikalar içinde otomatik tarayıcılar tarafından bulunabilir; özel depoda bile depoya erişimi olan herkes, eski bir yedek ya da müşteriye teslim edilen bir arşiv sızıntı kaynağı olabilir. Sonuç, anahtarın türüne göre değişir: bulut faturasında beklenmeyen harcama, veritabanındaki kişisel verilere erişim ya da sizin adınıza mesaj gönderen bir bot. Bu yazıda sızıntıların nasıl oluştuğunu, koddaki sırları nasıl bulacağınızı, bulduğunuzda ne yapmanız gerektiğini, sızıntıyı önleyen alışkanlıkları ve Otopilot'un Repo Gizli Anahtar Sızıntı Tarayıcı botunun bu kontrolü nasıl yaptığını anlatıyoruz.
API anahtarı sızıntısı nasıl oluşur?
Sızıntıların büyük bölümü kötü niyetten değil, alışkanlıktan doğar. Birkaç tipik senaryo şöyledir:
- Deneme kodu. Bir ödeme ya da yapay zekâ servisini denerken anahtar doğrudan kaynak dosyaya yazılır, çalışınca öyle kalır.
- Yanlışlıkla eklenen ortam dosyası. Anahtarların tutulduğu .env dosyası .gitignore'a eklenmeden depoya girer.
- Bağlantı dizesi. Veritabanı adresi kullanıcı adı ve parolayla birlikte yapılandırma dosyasına yazılır.
- Yardımcı dosyalar. .npmrc içindeki paket jetonu, yedek klasöründeki özel SSH anahtarı ya da test için dışa aktarılmış bir sertifika deposu.
- Paylaşılan arşiv. Müşteriye ya da serbest çalışana gönderilen ZIP dosyasında üretim ayarları kalır.
Bir sırrın koddan silinmesi, sızıntının bittiği anlamına gelmez. Git her değişikliği geçmişte saklar; anahtar bir commit'te bir kez yer aldıysa depo geçmişinde durur. Depoyu daha önce kopyalayan herkesin bilgisayarında da bulunur. Bu yüzden sızıntıya verilecek ilk yanıt dosyayı düzeltmek değil, anahtarı geçersiz kılmaktır.
Risk her anahtar için aynı değildir. Ödeme sağlayıcısının canlı gizli anahtarı, bulut hesabının erişim anahtarı ya da veritabanı parolası doğrudan para ve veri demektir. Tarayıcıda çalışan kodda zaten görünen ve alan adıyla sınırlandırılmış bir harita anahtarı ise daha düşük risk taşır. Önceliği belirlemek için hangi anahtarın neye eriştiğini bilmek gerekir.
Kodda gizli anahtar nasıl bulunur?
Elle arama küçük projelerde mümkündür ama güvenilir değildir. Anahtarlar farklı adlarla, farklı dosyalarda, bazen yorum satırlarında durur. Otomatik tarama iki yöntemi birlikte kullanır: bilinen biçimleri tanıyan kalıplar ve rastgelelik ölçümü.
Birçok hizmet anahtarlarına tanınabilir bir önek verir. Bu önekler, taramada yanlış alarmı azaltır:
| Hizmet | Anahtar biçimi (örnek önek) | Risk düzeyi |
|---|---|---|
| AWS | AKIA ile başlayan 20 karakter | Yüksek |
| GitHub | ghp_, gho_ ya da github_pat_ | Yüksek |
| Stripe | sk_live_ ya da rk_live_ | Yüksek |
| OpenAI | sk- ya da sk-proj- | Yüksek |
| Anthropic | sk-ant- | Yüksek |
| Slack | xoxb-, xoxp- gibi | Yüksek |
| Google API | AIza ile başlayan 39 karakter | Orta |
| Telegram bot | sayı, iki nokta ve AA ile başlayan jeton | Yüksek |
Her sırrın belirgin bir öneki yoktur. Kendi uygulamanızın parolası ya da bir servisin önek kullanmayan anahtarı, "password", "secret" ya da "api_key" gibi bir değişkene atanmış hâlde durur. Bu durumda tarayıcı değişken adına ve değerin rastgeleliğine bakar. "changeme" ya da "test1234" gibi düşük rastgelelikteki değerler genellikle örnek değerdir; harf, rakam ve sembollerin karışık olduğu uzun bir değer ise büyük olasılıkla gerçek sırdır. Rastgeleliği ölçmek için Shannon entropisi kullanılır.
Dosya adları da ipucu verir. .env, id_rsa, .pem ya da .p12 uzantılı dosyaların depoda bulunması, içeriğine bakmadan bile incelenmesi gereken bir durumdur. Buna karşılık .env.example gibi boş değerli örnek dosyalar normaldir.
Bağımlılık klasörleri (node_modules, vendor) taramada genellikle atlanır. Buradaki kod sizin değildir ve içindeki test anahtarları çok sayıda yanlış alarm üretir. Görsel, yazı tipi ve arşiv gibi ikili dosyalar da metin olarak taranmaz.
Taramada çoğu zaman gözden kaçan yerler de vardır. Sürekli entegrasyon yapılandırmaları (ör. iş akışı dosyaları), docker-compose dosyaları, veritabanı göç betikleri ve örnek veri yükleyen betikler sık sık gerçek parolalar içerir. Tarayıcıda çalışan ön yüz kodu da ayrı bir risktir: derlenen JavaScript dosyasına giren her değer, siteyi ziyaret eden herkes tarafından okunabilir. Bu yüzden gizli kalması gereken bir anahtar hiçbir zaman ön yüz koduna konmamalı, yalnız sunucu tarafında kullanılmalıdır. Mobil uygulama paketleri de benzer biçimde açılıp incelenebilir.
Belgeler ve notlar da kaynak olabilir. Proje klasöründeki bir kurulum notu, ekip üyesine bırakılmış bir metin dosyası ya da hata ayıklama sırasında dışa aktarılmış bir kayıt dosyası, anahtarı düz metin olarak barındırabilir. Taramayı yalnız kaynak koda değil, depodaki tüm metin dosyalarına uygulamak bu nedenle daha güvenlidir.
GitHub'ın kendi depolarında sunduğu gizli anahtar taraması, desteklenen hizmetlerin anahtarlarını bulup bazı sağlayıcılara bildirebilir. Bu özelliğin kapsamı depo türüne ve hesap planına göre değişir; ayrıntıları GitHub belgelerinde bulabilirsiniz. Bağımsız bir tarama, GitHub dışındaki arşivleri ve teslim edilecek ZIP dosyalarını da kontrol etmenizi sağlar.
Sızıntıyı bulduğunuzda ne yapmalısınız?
Bir anahtarın sızdığını fark ettiğinizde sıra önemlidir. Önce zararı durdurmak, sonra izleri temizlemek gerekir.
- Anahtarı iptal edin ya da yenileyin. İlgili hizmetin yönetim panelinde anahtarı devre dışı bırakın ve yenisini oluşturun. Veritabanı parolasıysa kullanıcının parolasını değiştirin.
- Kullanımı kontrol edin. Bulut hesabının etkinlik kayıtlarına, ödeme sağlayıcısının işlem listesine ya da yapay zekâ hizmetinin kullanım ekranına bakın; beklenmeyen bir hareket var mı?
- Yeni anahtarı koda değil ortama koyun. Değeri ortam değişkenine ya da sunucunuzdaki gizli anahtar deposuna taşıyın.
- Geçmişi temizleyin. Gerekiyorsa depo geçmişinden dosyayı ya da değeri çıkarın; GitHub bunun için yöntemler belgeler. Bu adım iptalin yerine geçmez.
- Kişisel veri etkilendiyse değerlendirin. Sızan anahtar kişisel verilere erişim sağlıyorsa, olayın KVKK kapsamındaki bildirim yükümlülüğü doğurup doğurmadığını değerlendirin.
Olayı kısa bir notla kayda geçirmek de sonraki adımlar için yararlıdır: hangi anahtarın, hangi dosyada, ne zamandan beri bulunduğu, ne zaman iptal edildiği ve yerine neyin konduğu. Bu not, benzer bir durumda ekibin daha hızlı hareket etmesini sağlar ve gerekirse hizmet sağlayıcıyla ya da müşteriyle yapılacak yazışmalarda dayanak olur. Anahtarı kullanan tüm sunucu ve uygulamaların yeni değerle güncellendiğini kontrol etmeyi unutmayın; aksi hâlde iptal sonrasında hizmet kesintisi yaşanabilir.
Sık yapılan hata, anahtarı yalnız koddan silip yeni bir commit atmaktır. Bu, anahtarı geçmişte bırakır ve sızıntı devam eder. Yapay zekâ anahtarları için harcama sınırı koymak, olası bir kötüye kullanımda zararı sınırlar; bu konuyu OpenAI API maliyeti ve bütçe tavanı yazımızda anlattık.
Sızıntıyı önleyen alışkanlıklar
Taramayı düzenli yapmak kadar, sızıntının hiç oluşmaması için alışkanlık edinmek de önemlidir. Küçük ekiplerde bile uygulanabilecek önlemler şunlardır:
- Projeye ilk günden .gitignore ekleyin ve .env dosyalarını listeye yazın.
- Depoda yalnız değerleri boş bırakılmış bir .env.example dosyası tutun.
- Her hizmet için ayrı anahtar kullanın ve anahtara yalnız gereken yetkiyi verin.
- Anahtarları belirli aralıklarla yenileyin; ayrılan ekip üyelerinin erişimini kapatın.
- Müşteriye ya da dışarıya arşiv göndermeden önce tarama yapın.
- Paylaşılan bir parola yöneticisi ya da sunucunuzdaki gizli anahtar deposu kullanın; anahtarları sohbet mesajıyla ya da e-postayla göndermeyin.
- Hesaplarda iki adımlı doğrulamayı açın; nasıl yapılacağını girişte doğrulama kodu ve iki adımlı doğrulama yazımızda bulabilirsiniz.
Anahtarların nerede saklanacağı ekibin büyüklüğüne göre değişir. Tek sunuculu küçük bir projede sunucudaki ortam değişkenleri yeterli olabilir; birden çok ortam ve ekip üyesi olduğunda merkezi bir gizli anahtar yönetimi daha düzenli bir yoldur. Hangisini seçerseniz seçin, temel kural aynıdır: kod deposu anahtarın yeri değildir.
Bazı ekipler commit öncesinde çalışan bir kontrol ekler; böylece anahtar depoya hiç girmeden yakalanır. Bu araçları kurmak ekip düzenine bağlıdır. Hangi yöntemi seçerseniz seçin, depoyu herkese açmadan, büyük bir sürüm öncesinde ve arşiv paylaşmadan önce bir tarama yapmak iyi bir alışkanlıktır.
Yapay zekâ servislerinin anahtarları, denemeler sırasında sık sık doğrudan koda yazıldığı için sızıntıya özellikle açıktır. Bu anahtarları nasıl saklamanız gerektiğini yapay zekâ API anahtarları rehberimizde ayrıntılı olarak anlattık.
Otopilot ile API anahtarı sızıntısı taraması
Otopilot'un Repo Gizli Anahtar Sızıntı Tarayıcı botu, kod deponuzu ve arşivlerinizi bilinen anahtar kalıpları ve rastgelelik ölçümüyle tarar. Üç yoldan kaynak verebilirsiniz:
- Herkese açık bir GitHub deposu için sahip/depo adını yazarsınız; bot depoyu GitHub'ın resmî API'sinden arşiv olarak indirir.
- Özel depolar ve diğer projeler için en çok 20 MB'lık ZIP arşivi yüklersiniz.
- Tek bir yapılandırma dosyasını ya da kod parçasını yapıştırırsınız.
Tarama AWS, GitHub, Slack, Stripe, Google, OpenAI, Anthropic ve Telegram anahtar kalıplarını, özel anahtar bloklarını, JWT'leri, bağlantı dizesindeki parolaları, .npmrc jetonlarını ve yüksek rastgelelikteki parola atamalarını arar. .env, id_rsa ve .pem gibi dosyalar adından işaretlenir. Bağımlılık klasörleri, ikili dosyalar ve 1 MB'tan büyük dosyalar atlanır; kaç dosyanın neden atlandığı raporda yazar.
Her bulgu dosya, satır, önem derecesi ve maskeli değerle listelenir. Değerin yalnız ilk dört ve son iki karakteri görünür; tam değer ekrana, CSV'ye ya da kayda yazılmaz. Her kural için ne yapılacağı da yazılıdır: hangi panelden anahtarın yenileneceği, değerin nereye taşınacağı. Test verisi gibi bilerek tutulan örnekler için yol yoksayma listesi ve satıra eklenen gizli-tarama:yoksay yorumu kullanılabilir.
Dosyalar yalnız tarama sırasında bellekte açılır; arşiv, kod ve sonuçlar sunucuda saklanmaz. Bot deponuza bir şey yazmaz, commit atmaz ve bulduğu anahtarı sağlayıcıya sorup denemez. Git geçmişindeki eski commit'ler taranmaz; bu yüzden tarama, düzenli iptal ve yenileme alışkanlığının yerini tutmaz, onu destekler. Paket seçenekleri için fiyatlar sayfasına bakabilirsiniz.
Sık sorulan sorular
Tarama için kodumu yüklemem güvenli mi?
Arşiv yalnız tarama süresince bellekte açılır; dosyalar diske yazılmaz, sonuçlar saklanmaz ve bulunan değerler maskelenir. Yine de tarama yetkiniz olan kodu yüklemelisiniz.
Bot özel GitHub depolarını tarayabilir mi?
Doğrudan bağlanmaz. Özel depoyu GitHub'dan ZIP olarak indirip yükleyebilirsiniz; bu sayede depo erişim jetonu vermeniz gerekmez.
Tarama temiz çıktıysa depom güvende mi?
Kural tabanlı tarama bilinen biçimleri ve yüksek rastgelelikteki değerleri bulur; bilinmeyen biçimdeki bir sırrı kaçırabilir. Ayrıca yalnız dosyaların son hâli taranır, geçmiş commit'ler taranmaz.
Örnek değerler bulgu olarak çıkıyor, ne yapmalıyım?
Örnek dosyaların bulunduğu klasörü yoksayılacak yollara ekleyin ya da ilgili satıra gizli-tarama:yoksay yorumunu yazın.
Anahtarı sildim, yine de yenilemem gerekir mi?
Evet. Anahtar git geçmişinde ve depoyu kopyalayanlarda kalır. Güvenli tek yol, anahtarı hizmetin panelinden iptal edip yenisini oluşturmaktır.
Kaynaklar
Bu sayfayı kim hazırladı?
Bu içeriği Otopilot kurucusu Ersin Dorlak, ürünü geliştiren ekiple birlikte hazırladı. Deneyimimizi kendi sitemizde ediniyoruz: otopilot.net'i de aynı panelden, 99 kurallı denetimle tarıyor ve çıkan bulguları düzeltiyoruz. Ölçmediğimiz bir rakamı ölçülmüş gibi yazmıyoruz.
Ekibimiz ve ilkelerimizSitenizde aynı kontrolleri yapın
Ücretsiz site analiziyle sayfalarınızdaki teknik ve içerik sorunlarını görün. Düzeltmeleri panelde hazırlamak ve sitenize uygulamak için planları inceleyin.