GitGuardian nedir? Ücretsiz plan, ggshield kurulumu, pre-commit, GitHub uygulaması ve MCP

GitGuardian'ı GitHub uygulamasıyla depolarına bağlarsın ya da ggshield adlı açık kaynak (MIT) komut satırı aracıyla commit atmadan önce bilgisayarında taratırsın; kodun içine yanlışlıkla bırakılan gizli anahtarları (API anahtarı, parola, erişim jetonu) bulup seni uyarır. Bir güvenlik hizmeti, yapay zekâ modeli değil. Ücretsiz plan var: 0 $, kredi kartı istemez, 25 katkıcı geliştiriciye kadar, 1 GB depo kapasitesi, ayda 10.000 API çağrısı. Ücretli planların fiyatı yayımlanmıyor. Pano ve belgeler İngilizce; Türkçe arayüz yok.

Ne yapar: Kodda unutulan gizli anahtarları bulur
ggshield: Açık kaynak (MIT), indirmesi ücretsiz
Türkçe: Arayüz ve belge yok
Veri bölgesi: Ücretsizde ABD (AB ücretli planda)
Ücretli plan: Fiyat yok, satışla görüşme
Ücretsiz plan: Var: 25 geliştiriciye kadar, kart yok

GitGuardian ne işe yarar?

Kodun içine yanlışlıkla yazılmış parola, API anahtarı ve erişim jetonu gibi gizli bilgilere sır (secret) denir. Bir sır GitHub'a çıktığında, dosyadan sonradan silinse bile eski commit'lerde durur. GitGuardian bu sırları iki yerde arar: GitHub'daki depolarında (panodan) ve kendi bilgisayarında, commit atmadan önce (ggshield ile).

Kod yazılırCommit atılır ya da GitHub'a gönderilir.

Taramaggshield yerelde, GitHub uygulaması depoda arar.

UyarıBulunan sır panoda ya da terminalde görünür.

Uyarıdan sonra anahtarı ilgili servisten iptal edip yenisini üret; dosyadan silmek yetmez.

GitHub depolarını sürekli taratmakNe alırsın: Panoda sızıntı kayıtları ve uyarıBağlantı gerekir Commit öncesi yerelde taramaNe alırsın: Sır bulunursa commit dururAyrı kurulum gerekir Yapay zekâ araçlarında sızıntıyı durdurmakNe alırsın: İstem ya da eylem engellenirAyrı kurulum gerekir

Kime yarar: GitHub'da kod tutan, özellikle yapay zekâ araçlarıyla hızlı kod yazan serbest geliştiriciye ve küçük ekiplere. Ticari ürün; ücretsiz planı sınırlı.

Kaynak: GitGuardian belgeleri ve ggshield README, 15.10.2026.

GitGuardian nasıl kurulur? ggshield, GitHub uygulaması ve pre-commit

Önce bir GitGuardian hesabı gerekir; hem pano hem ggshield bu hesaba bağlanır. Aşağıdan kullanmak istediğin yolu seç.

Hesap aç. dashboard.gitguardian.com adresinde GitHub ile, e-posta + parolayla ya da SSO ile kaydol. E-postayla açarsan onay e-postası gelir.
GitHub uygulamasını kur. GitHub ile kaydolursan kurulum ekranı kendiliğinden gelir. Sonradan Settings sonra Integrations sonra Sources ekranından GitHub için Install'a bas.
Nereye kurulacağını seç. Kişisel hesabın ya da yöneticisi olduğun kuruluş. Sonra All repositories (yeni depolar otomatik eklenir) ya da Only select repositories seç.
Beklemeden tarama başlar. Eklenen her depo için geçmiş tarama varsayılan olarak otomatik yapılır; yeni commit'ler gerçek zamanlı taranır.

Uygulama kodunu yalnız okur. Yazma izni isteğe bağlı ikinci bir uygulamayla verilir ve belgede yalnız Honeytoken dağıtımı için gerekiyor. Hesap açarken yaş, telefon ya da kimlik koşulunu resmî kaynak yazmıyor.

ggshield, GitGuardian'ın açık kaynak (MIT) komut satırı aracı. macOS, Linux ve Windows'ta çalışır; Python'un güncel bir sürümünü ister (bağımsız paketlerde gerekmez).

Linux / macOS (önerilen kurulum betiği)› curl -sSfL https://raw.githubusercontent.com/GitGuardian/ggshield/main/scripts/install/install.sh | bash

Windows PowerShell› irm https://raw.githubusercontent.com/GitGuardian/ggshield/main/scripts/install/install.ps1 | iex

Betik kurulumdan sonra giriş adımını da yapar. Betik kullanmak istemezsen: macOS'ta Homebrew, Windows'ta Chocolatey ya da MSI, Linux'ta deb/rpm paketi, her yerde pipx ile kurulur.

pipx ile (tüm işletim sistemleri)› pipx install ggshield

Giriş (tarayıcı açılır, jeton kendiliğinden üretilir)› ggshield auth login

İlk tarama› ggshield secret scan repo /yol/depo

ggshield API anahtarı olmadan çalışmaz. “API anahtarı gerekli” ya da “geçersiz anahtar” hatasında önce ggshield auth login'i çalıştır; elle kurmak istersen hesabından kişisel erişim jetonu üretip GITGUARDIAN_API_KEY ortam değişkenine koy.

Pre-commit kancası, commit oluşmadan hemen önce çalışır ve sır varsa commit'i durdurur. İki yolu var: pre-commit çerçevesi ya da ggshield'in kendi kurulumu.

Çerçeveyle: .pre-commit-config.yaml (README sürümü v1.55.0)

› repos:
  - repo: https://github.com/gitguardian/ggshield
    rev: v1.55.0
    hooks:
      - id: ggshield
        language_version: python3
        stages: [pre-commit]

Sonra kancayı kur

› pip install pre-commit
pre-commit install

Ya da ggshield ile tüm depolar için (önce GITGUARDIAN_API_KEY tanımlı olmalı)› ggshield install --mode global

Tek seferlik atlamak için git commit -n; yalnız ggshield'i atlamak için komutun önüne SKIP=ggshield yaz.

ggshield, Cursor, Claude Code, Codex, Copilot CLI, VS Code, Mistral Vibe, Kiro ve Junie CLI'nin kanca (hook) sistemine bağlanır. Kanca, istemini ve aracın çalıştıracağı komutu modele gitmeden tarar; sır bulursa durdurur. 1.53.0 ve üstü sürüm gerekir.

Bilgisayarındaki desteklenen araçları bulup kancayı yazar› ggshield machine setup

Yalnız yapay zekâ kancası (git kancası ve honeytoken olmadan)› ggshield machine setup --no-git-hooks --no-honeytokens

Bu komut araçların kendi ayar dosyalarına yazar (örneğin Claude Code için ~/.claude/settings.json) ve varsayılanda git kancalarını kurup bir honeytoken (sahte, tuzak anahtar) yerleştirir. Kanca giriş yapılmamışsa ya da API'ye ulaşamazsa engellemez, yalnız “taranmadı” uyarısı verir.

Kaynak: GitGuardian belgeleri (ggshield başlangıç, pre-commit, yapay zekâ araçları, GitHub entegrasyonu), ggshield README; 15.10.2026.

GitGuardian nasıl kullanılır? Tarama, uyarı ve yapay zekâ asistanı

Panoda bulguları aç. GitHub uygulamasını kurunca depolardaki sızıntılar panoda kayıt (incident) olarak listelenir.
Sızan anahtarı iptal et. Anahtarı ilgili servisten iptal edip yenisini üret. Belgeye göre sır git geçmişinde kalıcı durur; yalnız dosyadan silmek onu güvenli yapmaz.
Bilgisayarında da tara. ggshield ile commit atmadan önce taratırsan sır depoya hiç girmez.

Bir klasörü taramak› ggshield secret scan path -r .

Bir git deposunu taramak› ggshield secret scan repo .

Docker imajını taramak (docker gerekir)› ggshield secret scan docker ubuntu:22.04

Kalan API çağrı kotanı görmek› ggshield quota

Temiz bir tarama sonucu “güvenli” garantisi değildir; tarayıcı yalnız tanıdığı sır türlerini bulur.

MCP sunucusu (beta)

GitGuardian'ın MCP sunucusu, yapay zekâ asistanından koda “şu sırları tara” demeni sağlar. Belgeye göre beta; Developer profili çoğunlukla salt okur (tarama, olay listeleme, honeytoken üretme). Sır değerleri yapay zekâ modeline gönderilmez, tarama GitGuardian API'sinde yapılır. README Cursor, Claude Desktop, Claude.ai (Settings sonra Connectors sonra Add custom connector), Windsurf ve Zed için kurulum anlatıyor.

Asistana tarattırmak (README örneği, İngilizce)"Scan this codebase for any leaked secrets or credentials."MCP sunucusunun hangi planda kullanılabildiğini resmî kaynak yazmıyor; ücretsiz planda çalışıp çalışmadığını bağlanarak ya da support@gitguardian.com'a yazarak öğren.

Kaynak: ggshield README, GitGuardian MCP belgeleri ve gg-mcp README; 15.10.2026.

GitGuardian ücretsiz mi? Planlar ve fiyat

Evet, Starter (ücretsiz) plan var: süre sınırı yok, kredi kartı istemez. Ücretli Growth ve Enterprise planlarının fiyatı sitede yazmıyor; “satışla görüş” deniyor ve ücretli özelliklerin hepsini 30 gün deneyebiliyorsun. TL fiyat yok.

Free (Starter)0 $

25 katkıcı geliştiriciye kadar
1 GB depo kapasitesi
Sınırsız gerçek zamanlı tarama
Yapay zekâ araçları kancası (ggshield)
Ayda 10.000 API çağrısı
CI/CD ve konteyner tarama
VS Code eklentisi
Ekipler, SSO
AB veri bölgesi

GrowthSatışla görüş

12 GB depo kapasitesi
CI/CD ve konteyner tarama
Playbook'lar, SSO/SCIM
VS Code eklentisi
AB ve ABD veri bölgesi
Sınırsız API çağrısı
Kendi sunucuna kurulum

EnterpriseÖzel fiyat

Growth'un hepsi
60 GB depo kapasitesi
Kendi sunucuna kurulum
Sınırsız takım, özel dedektör

Tablo olarak gör (ücretsiz plan sınırları)

Özellik	Free	Growth	Enterprise
Depo kapasitesi	1 GB	12 GB	60 GB
Geçmiş tarama	En çok 500 (yalnız iç izleme)	Sınırsız	Sınırsız
Azami taranan dosya	1 MB	1 MB	10 MB
API çağrısı	Ayda 10.000	Sınırsız	Sınırsız
ggshield komut satırı	Sınırlı	Var	Var
Yapay zekâ IDE kancaları	Var	Var	Var
Takımlar	Yok	En çok 10	Sınırsız

Sayım şöyle: bir katkıcı geliştirici, son 90 günde bir iş deposuna en az bir commit atan kişi. Belgeye göre GitHub'da kuruluşa ait özel depolar sayılır; herkese açık depolar ve bireysel kullanıcı hesaplarının depoları sayılmaz. 25'i aşarsan 30 günlük deneme kendiliğinden başlar; deneme bitince iş depoların izlenmez ve satışla görüşmen istenir. Ücretsiz sınırın kişisel depolara nasıl uygulandığını belge ayrıca yazmıyor.

ggshield'in ücretsiz planda neyinin “sınırlı” olduğunu resmî kaynak açıklamıyor; bilinen sınırlar API kotası (ayda 10.000 çağrı, kayan ay; kişisel jetonla dakikada 50 istek). Bir çağrı en çok 20 dosyayı kapsar, yani 40 dosyalık bir commit 2 çağrı harcar.

Kaynak: GitGuardian fiyat sayfası ve Plan ve kullanım belgesi, 15.10.2026. ✓/✕ işaretleri belgedeki plan tablosundan. Fiyat sayfasında hâlâ eski Business/Teams sekmesi de duruyor; belgeye göre eski planlar artık sunulmuyor.

Resmî fiyat sayfası en son 28 Ekim 2026 tarihinde kontrol edildi.

GitGuardian lisansı, verisi ve Türkçe

Lisans

ggshield ve MCP sunucusu (gg-mcp) MIT lisanslı açık kaynak. Pano (SaaS) ticari bir hizmet; platform sözleşmesi herkese açık sayfada yok; çıktı hakları ve iade koşulları bu yüzden net değil.

Nelerini görür?

GitHub uygulaması kodu varsayılanda yalnız okur. GitGuardian, sır bulunan commit'in yamasını panoda göstermek için saklar; sır bulunmayan commit'lerin içeriğini toplamaz. Ayrıca push olaylarının üst verisini, depo adı ve boyutu gibi bilgileri ve fatura için kuruluş üyelerinin temel bilgisini alır.

ggshield ne gönderir?

Tarama için içerik GitGuardian API'sine gider. README yalnız çağrı zamanı, istek boyutu ve tarama modunun saklandığını ve dosya ile sırların saklanmadığını söylüyor; API belgesi ise her sır tespitinin kaydedildiğini ekliyor. pre-commit, pre-push ve yapay zekâ kancası taramaları makinenin ana bilgisayar adını da gönderir; kapatmak için .gitguardian.yaml içinde endpoint_registration: false yaz.

Yapay zekâ ve veri

GitGuardian'ın yapay zekâ politikası: müşteri verisi model eğitiminde kullanılmaz; harici sağlayıcılara gitmeden önce sırlar maskelenir ve sağlayıcılar eğitim yapmaz, veri tutmaz. Anonim performans verisiyle küçük iç modeller eğitilebilir.

Veri bölgesi

Ücretsiz plan tablosunda AB veri bölgesi yok; AB ve ABD seçimi Growth ve üstünde. Gizlilik bildirimi verinin ABD ofisiyle Standart Sözleşme Maddeleri altında paylaşılabileceğini söylüyor. KVKK'ya özel ifade yok.

Türkçe

Pano ve belgeler İngilizce (belgelerde ayrıca Fransızca var). Türkçe arayüz ya da Türkçe destek resmî kaynakta yazmıyor; ggshield örnek çıktıları İngilizce.

İptal ve hesap silme

Entegrasyonu kaldırmak için Settings sonra Integrations sonra Sources üzerinden Edit › Configure ile kaynağı sil; olay geçmişi korunur, tarama durur. Hesabı Settings sonra Personal sonra Account sonra Delete my account ile silersin; çalışma alanının sahibiysen çalışma alanı da silinir.

Kaynak: GitGuardian belgeleri (veri saklama, yapay zekâ yönetim politikası, plan, hesap silme), gizlilik bildirimi (29.07.2026); 15.10.2026. Hukuki görüş değildir.

Sık sorulan sorular

GitGuardian ücretsiz mi?

Evet, Starter planı 0 $ ve kredi kartı istemez: 25 katkıcı geliştiriciye kadar, 1 GB depo kapasitesi, ayda 10.000 API çağrısı. Ücretli planların fiyatı yayımlanmıyor.

ggshield nedir, ücretsiz mi, nasıl kurulur?

GitGuardian'ın komut satırı aracı; MIT lisanslı ve indirmesi ücretsiz. Kurulum betiğiyle, Homebrew, Chocolatey ya da pipx ile kurulur; çalışması için GitGuardian hesabından API anahtarı gerekir (ggshield auth login).

GitGuardian GitHub uygulaması kodumu değiştirebilir mi?

Hayır, varsayılanda yalnız okuma erişimi var. Yazma izni isteğe bağlı ikinci bir uygulamayla verilir ve belgede yalnız Honeytoken dağıtımı için gerekiyor.

ggshield dosyalarımı GitGuardian'a gönderiyor mu?

Tarama için içerik GitGuardian API'sine gönderilir. Belgeler dosya ve sırların saklanmadığını, üst verinin saklandığını söylüyor; API belgesi her sır tespitinin kaydedildiğini de yazıyor.

GitGuardian mı Gitleaks, TruffleHog ya da GitHub'ın kendi tarayıcısı mı?

Resmî kaynaklarda tarafsız bir karşılaştırma yok. ggshield README'si Gitleaks ve TruffleHog'u ilgili açık kaynak projeler olarak listeliyor. Karar için ücretsiz sınırlara (25 geliştirici, 1 GB, 10.000 çağrı) ve ggshield'in 'sınırlı' işaretine bak.

GitGuardian Türkçe mi?

Hayır. Pano ve belgeler İngilizce (belgelerde Fransızca da var); Türkçe arayüz ya da destek resmî kaynakta yazmıyor.

İlgili rehberler

Kaynaklar

Resmî kaynaklarda net olmayanlar: Platform sözleşmesi (herkese açık sayfada yok): çıktı hakları, iade, ticari kullanım, hesap kapatma koşulları · Ücretli plan fiyatları ve TL karşılığı · Hesap açmada yaş, telefon ya da kimlik koşulu · Panonun Türkçe seçeneği · ggshield'in ücretsiz planda neyinin “sınırlı” olduğu · MCP sunucusunun ücretsiz planda kullanılıp kullanılamadığı · Ücretsiz sınırın kişisel GitHub depolarına uygulanışı. Her biri ilgili bölümde ne yapabileceğinle birlikte yazılı.