Açık kaynak proje / 2026
TokenGuard
Git commit'i öncesinde hazırlanan değişikliklerde API anahtarlarını ve kimlik bilgilerini tarayan, sıfır bağımlılıklı bir Python aracı.
Problem
Geliştiricilerin; token’ları, özel anahtarları ve yüksek entropili dizgileri commit’ten önce yakalayan, kodu hiçbir yere göndermeyen hızlı bir yerel denetime ihtiyacı var.
Yaklaşım
TokenGuard, stage’lenmiş değişiklikleri desen kuralları ve Shannon entropi analiziyle tarıyor; kabul edilen test kimlik bilgileri açık bir baseline dosyasıyla bastırılabiliyor.
Sistem mimarisi
Saf Python standart kütüphanesi, sıfır harici bağımlılık; sonuçlar GitHub Code Scanning entegrasyonu için OASIS SARIF v2.1.0 olarak üretiliyor.
Kararlar ve sonuç
Her bulgu; önem derecesi, maskelenmiş değer önizlemesi, entropi skoru ve somut bir düzeltme önerisi taşıyor — belirsiz uyarı yok. PyPI’da tokenguard-cli olarak kurulabiliyor. Hazırlanan değişiklikleri tarıyor, bulduğu değerleri raporda maskeliyor; pre-commit kancası ve SARIF çıktısı sunuyor.
Kullanım Alanları ve Komutlar
- git push öncesi staged değişikliklerde API anahtarı, token ve yüksek entropili secret sızıntılarını yerel pre-commit kancasıyla engellemek isteyen ekipler.
- Harici binary veya SaaS bağımlılığı kurmadan GitHub Code Scanning için OASIS SARIF v2.1.0 raporu üretmek isteyen Python / CI hatları.
- Kabul edilen test anahtarlarını baseline dosyasıyla bastırıp gerçek üretim kimlik bilgisi sızıntılarını sıfır yanlış alarmla yakalamak.
# Kurulum ve ilk tarama / Install and scan staged changes
pip install tokenguard-cli
tokenguard scan --staged
# GitHub Code Scanning için SARIF çıktısı / Emit SARIF v2.1.0 report
tokenguard scan --staged --format sarif > tokenguard.sarif