İçeriğe atla
← Blog
Güvenli Yazılım

GitHub'a Yanlışlıkla Şifre ya da API Anahtarı Yükledim: Ne Yapmalıyım?

GitHub'a yanlışlıkla şifre yükledim diyorsan dosyayı silmek yetmez. Anahtarı iptal et, faturana bak, geçmişi temizle, push korumasıyla tekrarını önle.

Yazan: AltaySec AkademiSon güncelleme: 9 dk okuma
Bu konunun dersi: Gizli anahtarları koddan çıkarmak: yönetim ve döndürmeGüvenli Yazılım Geliştirme yolu · 14 dk · ücretsiz, kayıt gerekmez

GitHub'a yanlışlıkla şifre yükledim diyorsan ilk iş dosyayı silmek değil, o şifreyi ya da API anahtarını sağlayıcının panelinden iptal edip yenisini üretmektir. Silinen dosya git geçmişinde durur. Herkese açık bir depoya gittiyse birinin onu görmüş olduğunu varsay. Ardından kullanım kayıtlarını ve faturayı kontrol et, gerekiyorsa geçmişi temizle, sonra .gitignore ve push korumasıyla tekrarını önle.

GitHub'a yanlışlıkla şifre yükledim, ilk ne yapmalıyım?

Önce neyin sızdığını belirle, sonra onu geçersiz kıl. Sıra önemlidir. Geçmişi temizlemek zahmetli bir iştir, iptal ise çoğu zaman birkaç dakika sürer. İptal edilmiş bir anahtar geçmişte kalsa bile işe yaramaz.

  1. Neyin sızdığını bul. Commit'i aç ve görünen değerleri listele: hesap şifresi, API anahtarı, veritabanı parolası, erişim jetonu (token).
  2. İptal et ve yenisini üret. Aşağıdaki tablodan doğru panele git. Yeni değeri koda değil, ortam değişkenine yaz.
  3. Kullanımı kontrol et. Commit'in gönderildiği andan bugüne kadarki istekleri, faturayı ve oturum kayıtlarını incele. Tanımadığın bir hareket varsa ekran görüntüsü al.
  4. Uygulamanı yeni değerle çalıştır. Eski anahtarı kullanan proje şimdi hata verir, bu beklenir.
  5. Geçmişi temizlemeye karar ver. İptal ettiysen bu adım acil değildir.
  6. Gerekirse haber ver. Anahtar staj yaptığın şirkete, okul kulübüne ya da ekip projesine aitse sorumluya hemen yaz.
Sızan şeyNerede iptal edilirEk adım
Hesap şifresi (e-posta, okul, oyun)O hizmetin şifre değiştirme sayfasıAynı şifreyi kullandığın her yerde değiştir, iki adımlı doğrulamayı aç
GitHub erişim jetonu (PAT)GitHub ayarlarındaki Developer settings bölümüHerkese açık depoya gittiyse GitHub jetonu kendisi iptal eder, yenisini üretirsin
Yapay zekâ API anahtarıSağlayıcı konsolundaki API anahtarları sayfasıKullanım ve fatura sayfasını incele, harcama sınırı koy
Veritabanı parolası ya da bağlantı dizesiVeritabanı ya da barındırma paneliErişim kayıtlarına bak, içinde başkalarının verisi var mı düşün
Bulut erişim anahtarıBulut sağlayıcısının kimlik ve erişim (IAM) paneliTanımadığın sunucu ya da kaynak açılmış mı kontrol et

GitHub'ın dokümanına göre geçerli bir kişisel erişim jetonu herkese açık bir depoya ya da gist'e gönderilirse otomatik iptal edilir. Hesap şifresi sızdıysa yeni şifrenin yanına ikinci bir katman da ekle. Hangi yöntemin daha sağlam olduğunu iki adımlı doğrulama rehberinde bulabilirsin.

Dosyayı silmek neden yetmez?

Git her commit'i ayrı bir anlık görüntü olarak saklar. Dosyayı silip yeni commit attığında yalnız son hâl değişir. Eski commit depoda kalır, git log ve git show ile açılır. GitHub'da da o commit'in sayfası özetiyle erişilebilir kalır.

Silmenin yetmediği üç durum daha var:

  • Force push ile geçmişi ezmek: GitHub'ın dokümanına göre eski commit'ler, önbellekteki görünümler temizlenene kadar SHA-1 özetleriyle açılabilir. Truffle Security blogunda yayımlanan bir araştırma, force push ile üzerine yazılmış commit'leri herkese açık GitHub olay arşivinden bulup taradı ve hâlâ geçerli sırlara ulaştı. En sık kaynaklardan biri .env dosyasıydı.
  • Depoyu silmek: Herkese açık bir depoyu sildiğinde etkin bir çatal (fork) ağın yeni ana deposu olur.
  • Depoyu gizliye almak: Herkese açık çatallar ayrı bir ağda herkese açık kalır.

Kısacası asıl çözüm, değeri geçersiz kılmaktır. Bu sırayı tarayıcıda denemek istersen Saha'daki Commit'te Kalan Anahtar görevini aç. Kurgu bir kargo şirketinin deposunda gitleaks ile eski bir commit'te unutulmuş ödeme anahtarını bulursun. Aynı anahtarın hâlâ ortam dosyasında kullanıldığını görür, onu panelden döndürür ve eski anahtarın geçersiz olduğunu doğrularsın. Görev ücretsizdir, kurulum istemez, telefonda da açılır. Komutları giriş yapmadan deneyebilirsin, flag göndermek için giriş yapman gerekir.

API anahtarım sızdı, fatura riski var mı?

Evet, ücretli bir anahtarda en somut risk budur. Ücretli bir API anahtarını ele geçiren biri senin hesabın üzerinden istek atar, fatura sana gelir. Yapay zekâ servislerinde ücretli kullanım istek başına hesaplanır ve otomatik bir betik kısa sürede yüksek kullanım üretebilir.

Sorun büyüyor. GitGuardian'ın 2026 sır yayılımı raporuna göre 2025'te herkese açık GitHub commit'lerinde 28,6 milyondan fazla yeni sır tespit edildi. Yapay zekâ servislerine ait sırlar bir yılda yüzde 81 arttı.

Bazı sağlayıcılar GitHub ile birlikte çalışır. GitHub, herkese açık bir depoda ortak sağlayıcılardan birinin anahtarını bulunca sağlayıcıya haber verir. Kasım 2026 itibarıyla durum şöyle:

SağlayıcıHerkese açık depoda bulunursaSenin yapacağın
Anthropic (Claude API)Anahtar otomatik devre dışı bırakılır, sahibine e-posta giderKonsolda yeni anahtar üret, Usage ve Logs sayfalarına bak, Billing ayarlarını gözden geçir
OpenAIAnahtar OpenAI'a iletilir. GitHub'ın 2021 duyurusuna göre kapatılır ve sahibine haber verilirEski anahtarı sil, yenisini üret, kullanım sayfasını incele
Google GeminiGoogle anahtarı şifre gibi korumanı ve asla Git'e eklememeni isterYeni anahtar üret, kodunu onunla yayına al, sonra sızan anahtarı Cloud konsolunda devre dışı bırak ve fatura kayıtlarına bak

Otomatik kapanma bir emniyet ağıdır, plan değildir. Kişisel özel depoda, Discord'a yapıştırılan kodda ya da paylaşılan bir ekran görüntüsünde bu tarama çalışmaz. Anahtarı kendin iptal et ve fatura için iki ayar yap:

  • Harcama sınırı: Anthropic, Billing sayfasındaki harcama sınırlarının ve otomatik bakiye yükleme eşiklerinin sızan anahtara ve hatalı koda karşı emniyet olduğunu yazar. Otomatik yüklemeyi açtıysan eşiği düşük tut.
  • Bütçe uyarısı: Google Cloud'da yalnız uyarı veren bütçe harcamayı kendiliğinden durdurmaz. Bazı servislerde harcamayı durduran tavan bütçesi (spend cap) kurulabilir. Google'ın bütçe dokümanına göre kullanım faturaya gecikmeli yansır, bu yüzden bütçeyi elindeki paranın altında tut.

Beklenmedik bir harcama gördüysen sağlayıcının destek ekibine yaz, zaman çizelgeni ve ekran görüntülerini ekle. Geri ödeme yapıp yapmamak sağlayıcının kararıdır.

Henüz push etmediysen commit'i nasıl geri alırsın?

Commit'i yalnız kendi bilgisayarında attıysan ve GitHub'a göndermediysen iş kolaydır. git status çıktısında "Your branch is ahead of 'origin/main' by 1 commit" yazıyorsa commit henüz gitmemiştir. Dosyayı takipten çıkarır ve son commit'i düzeltirsin:

git rm --cached .env
echo ".env" >> .gitignore
git add .gitignore
git commit --amend --no-edit

git rm --cached dosyayı diskten silmez, yalnız Git'in takibinden çıkarır. git commit --amend son commit'i bu düzeltilmiş hâliyle değiştirir, depodaki tek commit buysa da çalışır. GitHub'ın .gitignore dokümanı da zaten izlenen bir dosyayı yok saymadan önce takipten çıkarman gerektiğini yazar. Anahtar daha eski bir commit'te de varsa bu yöntem yetmez. Bir kez bile herkese açık depoya gittiyse anahtarı yine iptal et.

Git geçmişinden şifre nasıl silinir?

GitHub, geçmişi temizlemek için git-filter-repo aracını önerir. Ama GitHub'ın gizli tarama dokümanı, anahtar iptal edildiyse geçmişi temizlemenin zaman alan ve çoğu zaman gereksiz bir iş olduğunu yazar. Temizlik şu durumlarda değer: değiştiremediğin bir bilgi sızdıysa (telefon numarası, adres gibi kişisel veri), depoyu portfolyonda göstereceksen ya da staj yerinin kuralı bunu istiyorsa.

GitHub'ın resmî adımları, kurgu bir hava-durumu-botu deposunda şöyle görünür:

git clone https://github.com/KULLANICI_ADIN/hava-durumu-botu
cd hava-durumu-botu
git-filter-repo --sensitive-data-removal --invert-paths --path config/.env
git push --force --mirror origin
  • --sensitive-data-removal bayrağı git-filter-repo 2.47 ve sonrasında vardır. Araç paket yöneticisiyle kurulur, macOS'ta brew install git-filter-repo gibi.
  • --path dosyanın depodaki tam yoludur. Dosya yer değiştirdiyse her eski yol için ayrı --path eklersin.
  • Bütün dosyayı değil yalnız değeri silmek için --replace-text ../sizan-degerler.txt kullanılır. Bu dosya silinecek değerleri tutar, işin bitince onu da sil.

Sonrasında şunlara dikkat et:

  • Commit özetleri değişir. Ekip arkadaşın eski kopyasıyla git pull ve git push yaparsa sır geri gelir. Herkes depoyu yeniden klonlamalı.
  • Dal koruması açıksa force push reddedilir. Geçici olarak kapatıp yeniden denersin. refs/pull/ ile başlayan referanslarda hata görmen ise normaldir, onlar GitHub'da salt okunurdur.
  • Çatallardaki kopyaları sen silemezsin, sahiplerinden istemen gerekir.
  • Pull request kayıtları ve önbellekteki görünümler için GitHub Support'a başvurursun. Destek ekibi, risk yalnız anahtarı döndürerek giderilebiliyorsa bu temizliği yapmaz.

GitHub gizli tarama ve push koruması nasıl çalışır?

GitHub iki katmanla korur: gizli tarama sızmış sırrı bulur, push koruması sırrın depoya girmesini baştan durdurur. Kasım 2026 itibarıyla durum şöyle:

  • Gizli tarama (secret scanning): Herkese açık depolarda ücretsiz ve otomatik çalışır. Bütün dallarda git geçmişinin tamamını, issue ve pull request metinlerini tarar. Bulgular deponun güvenlik sekmesinde uyarı olarak görünür. Ortak sağlayıcıların anahtarları ise doğrudan sağlayıcıya bildirilir, senin uyarı listende görünmez. Kuruluşlara ait özel depolarda GitHub Secret Protection ürünü gerekir.
  • Kullanıcı için push koruması: Varsayılan olarak açıktır ve herkese açık depolara sır göndermeni durdurur. Ayarı profil resminden Settings, ardından Code security bölümündeki "Push protection for yourself" satırında görürsün. Bu ayarı açık bırak.
  • Depo düzeyinde push koruması: Varsayılan olarak kapalıdır, depo yöneticisi açar. Biri engeli aştığında güvenlik sekmesinde uyarı oluşur.

Push koruması seni durdurduğunda engeli üç gerekçeyle aşmana izin verir: "It's used in tests", "It's a false positive" ve "I'll fix it later". Gerçek bir anahtar için hiçbirini seçme. Commit'i düzelt, değeri ortam değişkenine taşı, sonra yeniden gönder. GitHub'ın desen listesinde Anthropic ve OpenAI API anahtarları push korumasının tanıdığı türler arasındadır, Google API anahtarı ise değildir.

Bir daha olmaması için .env ve .gitignore nasıl kurulur?

Kural basit: sır koda girmez, ortamdan okunur. Öğrenci projesi için şu düzen yeter:

  1. Proje kökünde bir .env dosyası aç ve değerleri oraya yaz.
  2. İlk commit'ten önce .gitignore dosyasına .env satırını ekle.
  3. Depoya yalnız .env.example koy. İçinde değişken adları olsun, değerler boş kalsın.
  4. Kodda değeri ortamdan oku, Python'da os.environ["HAVA_API_ANAHTARI"] gibi.
  5. Commit'ten önce git diff --staged ile ne gönderdiğini oku. Yapay zekâ kod asistanı kullanıyorsan bu adımı atlama, asistanın eklediği dosyaları da gör.
  6. Otomatik tarama ekle. gitleaks'in güncel sürümünde depo taraması gitleaks git komutuyla yapılır, eski gitleaks detect yazımı da hâlâ çalışır. Araç commit öncesi kanca olarak da kurulabilir. Kendi kancanı yazacaksan bash betikleri rehberindeki güvenli betik kurallarına bak.

Basit bir .gitignore örneği:

.env
*.pem
*.key

Bu kurallar yalnız henüz takip edilmeyen dosyalara uygulanır. .env daha önce commit'e girdiyse önce git rm --cached .env ile takipten çıkar.

Ön yüz kodunu ayrıca düşün. Tarayıcıda çalışan JavaScript'e koyduğun anahtarı her ziyaretçi okuyabilir. Google'ın Gemini API anahtarı dokümanı, istemci koduna gömülen anahtarların çıkarılabileceğini yazar ve isteği bir arka uç sunucusu üzerinden yapmanı önerir. API tarafındaki diğer riskleri OWASP API Top 10 rehberinde bulursun. Gizli tarama kontrolünün geliştirme hattının neresine oturduğunu DevSecOps yazısı anlatır. Anahtar yönetimini ve döndürmeyi sırayla öğrenmek için Gizli anahtarları koddan çıkarmak dersine geç.

Projeni jüriye ya da işverene açık depo olarak göstereceksen bu düzeni ilk günden kur. Konu arıyorsan siber güvenlik proje fikirleri listesine bak.

Ekip ya da staj projesinde sızdıysa ne yapmalısın?

Başkasına ait bir anahtar sızdıysa saklama, hemen haber ver. Staj yaptığın şirketin, okul kulübünün ya da ekip projesinin sorumlusuna ne sızdığını, hangi commit'te olduğunu ve ne zaman fark ettiğini yaz. Anahtarı iptal etme yetkisi çoğu zaman onlardadır. Her gecikme kötüye kullanmak isteyene zaman kazandırır.

Sızan anahtar kişisel veri tutan bir sisteme açılıyorsa konu büyür. 6698 sayılı Kişisel Verilerin Korunması Kanunu'nun 12. maddesine göre işlenen kişisel veriler kanuni olmayan yollarla başkalarınca elde edilirse veri sorumlusu bunu en kısa sürede ilgili kişiye ve Kurula bildirir. Bu bildirimi sen değil, verinin sorumlusu olan kurum yapar. Senin görevin olanı eksiksiz ve hızlı anlatmaktır.

Son bir not: başkasının deposunda unutulmuş bir anahtar görürsen onu deneme. İzinsiz kullanmak bilişim suçu olabilir. Depo sahibine bildir, gerisini ona bırak.

Kaynaklar

Sık sorulan sorular

GitHub'da commit'i silersem şifrem görünmez olur mu?

Hayır. Dosyayı silip yeni commit atmak yalnız son hâli değiştirir, eski commit geçmişte kalır ve açılabilir. Force push ile geçmişi ezmek de yetmeyebilir, çünkü çatallar, klonlar ve önbellekteki görünümler eski commit'i tutabilir. Güvenli yol, şifreyi ya da anahtarı sağlayıcıda iptal edip yenisini üretmektir. Temizlik ondan sonra gelir.

Özel (private) depoya şifre yüklemek de tehlikeli mi?

Daha az ama yine risklidir. Depoya erişimi olan herkes geçmişi okuyabilir, depo ileride herkese açık yapılırsa bütün geçmiş de açılır. GitHub'ın ücretsiz gizli taraması ve ortak sağlayıcıların otomatik iptali herkese açık depolarda çalışır, kişisel özel depoda seni uyaran olmayabilir. Bu yüzden özel depoda da anahtarı döndür ve .env düzenine geç.

GitHub api key sızdı, OpenAI ya da Claude anahtarım kendiliğinden kapanır mı?

Herkese açık depoda büyük olasılıkla evet. GitHub bu sağlayıcıların anahtarlarını tanır ve sağlayıcıya iletir. Anthropic, bulunan Claude API anahtarını otomatik devre dışı bıraktığını ve e-posta gönderdiğini yazar. Yine de buna güvenme. Konsola gir, eski anahtarı sil, yenisini üret, kullanım sayfasına bak ve harcama sınırı ya da bütçe uyarısı kur.

Depoyu silmek ya da gizliye almak sorunu çözer mi?

Çözmez. GitHub'ın dokümanına göre herkese açık bir depoyu sildiğinde etkin bir çatal ağın yeni ana deposu olur. Depoyu gizliye aldığında da herkese açık çatallar ayrı bir ağda açık kalır. Bu sürede depoyu klonlamış biri varsa kopyası onda durur. Sızan değeri iptal etmek bu yolların hepsini etkisiz bırakır.

Gizli (secret) gist'e şifre koymak güvenli mi?

Hayır. GitHub'ın kendi dokümanı gizli gist'lerin özel olmadığını yazar. Bağlantıyı bilen herkes içeriği görür, bağlantıyı tanımadığın biri bulursa o da görür. GitHub'ın gizli taraması gizli gist'leri de tarar, ama sızıntıyı önlemez, yalnız sonradan yakalar. Şifre ve anahtar saklamak için gist değil, parola yöneticisi ya da sağlayıcının sır yönetimi aracını kullan.

  • GitHub
  • API anahtarı
  • gizli tarama
  • git geçmişi
  • .gitignore

İlgili yazılar

Okuduğunu uygula.
Ücretsiz. Hesap açınca bitirdiğin dersler puanıyla hesabına geçer.
İlk derse başla