Güvenlik

Agentbits yapay zeka ajanlarına gerçek yetkiler verir: dosya düzenlemek, komut çalıştırmak, sunuculara, veritabanlarına ve bağlı uygulamalara ulaşmak. Bu sayfa bunun arkasındaki güvenlik modelini, her kuralın nerede uygulandığını ve erişim vermeden önce bilmen gereken sınırları anlatır.

İlkeler

• Varsayılan olarak kapalı. Ajanlar bağlantılara, dosya eklerine, skill’lere ve uygulamalara ancak sen izin verirsen, ajan bazında erişir. Erişim her işlem anında Agentbits içinde denetlenir. Ajanın talimatlarında yazanlar hiçbir zaman bir erişim denetimi sayılmaz.
• Riskli işlemlerde onay. Production bağlantılardaki değişiklikler ve Önce bana sor politikalı uygulama araçları senin onayını bekler. Onay verdikten sonra erişim yeniden denetlenir; istek beklerken ajanın erişimini düşürürsen istek düşer.
• Güvenilmeyen içerik veri olarak kalır. Dosya içerikleri, sorgu sonuçları, komut çıktıları, uygulama sonuçları ve hafıza notları modele talimat olarak değil, güvenilmeyen veri olarak işaretlenmiş şekilde gider.
• Sırlar ana süreçte kalır. Yalnızca işletim sistemi onları şifreleyebiliyorsa saklanır.
• Dürüst arayüz. Agentbits’in uygulayamadığı bir kısıt uygulanıyormuş gibi gösterilmez. Tarayıcı ve Terminal izinlerinin açıklamaları bunu açıkça söyler.

Verilerin yerelde kalır

Her şey (organizasyon, projeler, sohbetler, görevler, hafıza, raporlar, dosyalar, denetim kaydı) bilgisayarındaki bir SQLite veritabanında saklanır:

Sistem	Veri klasörü
Windows	%APPDATA%\Agentbits
macOS	~/Library/Application Support/Agentbits
Linux	~/.config/Agentbits

AGENTBITS_DATA_DIR ortam değişkeniyle Agentbits’i başka bir klasöre yönlendirebilirsin. Veri klasörü başına yalnızca bir Agentbits penceresi çalışır; uygulamayı yeniden açmak mevcut pencereyi öne getirir.

Agentbits sunucusu, hesap ya da telemetri yoktur. Ağ trafiği yalnızca şuralara gider:

• ayarladığın sağlayıcılara ve Claude Code / Codex CLI’ların kendisine,
• eklediğin bağlantılara ve uygulamalara,
• oradan bir skill kurduğunda ya da güncellediğinde GitHub’a,
• yerleşik Browser’da açtığın sitelere,
• destek düğmesine tıklarsan, sistem tarayıcında destek sayfasına.

Yedek, geri yükleme ve sıfırlama için bkz. Ayarlar.

Sırlar

API anahtarları, veritabanı ve SSH parolaları, özel anahtarlar, uygulamaların ortam değişkenleri ve başlıkları ile OAuth token’ları işletim sisteminin anahtar zinciriyle şifrelenir (Windows DPAPI, macOS Keychain, Linux Secret Service). Arayüze, prompt’lara, terminallere ya da loglara asla gönderilmez. Sır alanları yalnızca yazılabilir: kayıtlı bir değer nokta olarak görünür ve yalnızca değiştirilebilir.

Çalışan bir anahtar zinciri yoksa (ör. Secret Service olmayan bir Linux sistemi) Agentbits sırları daha zayıf bir biçimde saklamak yerine kaydetmeyi reddeder.

Ayarlar → Veri yönetimi altındaki Her şeyi sıfırla kayıtlı API anahtarlarını da siler. Yedekler bunları şifreli olarak tutar; Windows’ta yalnızca aynı bilgisayardaki aynı kullanıcı tarafından yeniden çözülebilirler.

Ne nerede uygulanır

Alan	Nasıl uygulanır
Dosyalar, terminal, ağ	Sağlayıcı üzerinden: Claude Code’un araç listesi ve klasör sınırları, Codex’in sandbox’ı. API sağlayıcılarında dosya sistemi ya da terminal hiç yoktur. Bkz. İzinler.
Depo ayarları	Claude Code deponun kendi .claude ayarları ve hook’ları olmadan çalışır ve .mcp.json dosyasını yok sayar. Codex’in kısıtsız modu hiçbir zaman kullanılmaz.
Sunucular ve veritabanları	Her çağrıda Agentbits denetler: erişim seviyesi, ifade sınıflandırması, Production onayı, denetim kaydı. Ajan okumaları salt-okunur bir veritabanı kullanıcısıyla yapılır; böylece yazmaları veritabanının kendisi reddeder. Bkz. Bağlantılar.
Uygulamalar (MCP)	Ajanlar bir uygulamaya hiçbir zaman doğrudan bağlanmaz. Her çağrı erişim denetiminden, aracın politikasından, onaylardan ve denetim kaydından geçer. Bkz. Uygulamalar.
Skill’ler	Bir skill kurulurken hiçbir şey çalıştırılmaz. Ajanlar yalnızca kendilerine atanan skill’leri görür. Bkz. Skill’ler.
Dosya ekleri	Ajanlar yalnızca kendileriyle paylaşılan dosyaları okur; içerik veri olarak ele alınır ve talimat benzeri satırlar işaretlenir. Bkz. Dosyalar.
Proje klasörleri	Agentbits fazla geniş klasörleri (bir sürücü kökü, kullanıcı klasörün, Agentbits veri klasörü) reddeder ve gerçek konumu denetlemek için bağlantıları (link) izler.
Uygulamanın kendisi	Pencere sandbox içinde çalışır; yerleşik Browser’a hiçbir cihaz izni verilmez.

Güvenilmeyen içerik ve prompt enjeksiyonu

Dışarıdan gelen metin (bir dosya, bir sorgu sonucu, bir komut çıktısı, bir uygulamanın döndürdüğü e-posta) ajanı yanıltmak için yazılmış talimatlar içerebilir. Agentbits bunların hepsini güvenilmeyen veri olarak işaretler ve ajanlara içlerindeki talimatlara uymamalarını söyler. Dosyalardaki talimat benzeri satırlar sana uyarı olarak gösterilir. Skill’ler farklıdır: ajanlar onları talimat olarak okur; bu yüzden önizleme, bir skill’i kurmadan önce şüpheli satırları işaretler. Bu riski azaltır ama bir modelin nasıl davranacağını garanti edemez; bir şeyi değiştiren işlemlerde onayları açık tut.

Açıkça yazılı sınırlar

Bunlar bulunmayı bekleyen hatalar değil, bilinen sınırlardır:

• Terminal, senin kullanıcı yetkilerin demektir. Terminal izni olan bir Claude Code ajanı, işletim sistemi kullanıcının yapabildiği her şeyi yapabilir. Terminal ve Ağ birlikteyse bilgisayarında kayıtlı kimlik bilgileriyle (~/.ssh, .pgpass, ortam değişkenleri) bağlantı denetimlerinin dışında sunuculara ve veritabanlarına da ulaşabilir. İşletim sistemi düzeyinde yalıtım yoktur: bu izinleri yalnızca güvendiğin ajanlara ver ya da Agentbits’i kısıtlı bir işletim sistemi kullanıcısıyla çalıştır.
• Bağlantılarda asıl güvence sunucudadır. İfade ve komut sınıflandırması sezgiseldir. Ayrı bir salt-okunur veritabanı hesabı ve kısıtlı bir SSH kullanıcısı kullan.
• Yerel uygulamalar senin adına çalışır. Yerel (stdio) bir MCP sunucusu senin yetkilerinle çalışan bir programdır; Agentbits onu kısıtlayamaz. Araçlardaki salt-okunur ve yıkıcı işaretlerini sunucu bildirir.
• OAuth girişini yalnızca güvendiğin sunuculara yap. Parola girmeden önce açılan giriş sayfasının adresini kontrol et.
• Durdurmak her yerde anında değildir. Başlamış bir veritabanı sorgusu ya da SSH komutu kendi süre sınırı içinde (30 ile 60 saniye) biter. Bir CLI ajanını duraklatmak sürecini dondurmaz.
• Bazı şeyler tam olarak saklanır. Ajan terminalleri, ajanlara gönderilen tam prompt’ları log saklama süresi onları silene kadar tutar. Denetim kaydının saklama süresi yoktur; yalnızca Her şeyi sıfırla temizler.
• Harcama tavanı yok. Görev başına bütçe, token ya da toplam süre sınırı yoktur.
• Ortam değişkenleri olduğu gibi geçer. Claude Code ve Codex CLI’larına ortam değişkenleri olduğu gibi aktarılır (giriş, proxy ve PATH için gerekir).
• Paketler imzasızdır. Kurulum dosyaları yayımlandığında kod imzalı olmayacak; Windows SmartScreen uyarı verecek.

Ekim 2026’daki bağımsız bir güvenlik incelemesi bu alanları kapsadı. Bulguların çoğu düzeltildi; kalanlar kısmen giderildi, yukarıda sınır olarak belgelendi ya da hâlâ açık. Tam durum tablosu depodaki docs/SECURITY.md dosyasında.

Güvenlik açığı bildir

Güvenlik sorunları için lütfen herkese açık bir issue açma. GitHub üzerinden gizli olarak bildir: Report a vulnerability (depo → Security → Report a vulnerability).

Şunları ekle:

• Agentbits sürümü (Ayarlar → Genel, Agentbits v<sürüm> gösterir) ve işletim sistemin,
• varsa ilgili sağlayıcı (Claude Code CLI, Codex CLI, Anthropic API, OpenAI API ya da Demo),
• yeniden oluşturma adımları, ne beklediğin ve ne olduğu,
• senin gördüğün kadarıyla etkisi: ör. bir ajanın izinlerini aşması, bir sırrın ana süreçten çıkması ya da onayların veya denetim kaydının atlanması.

Gerçek API anahtarları, parolalar ya da kişisel veriler ekleme.

Kapsamda olanlar: bir ajanın, dosyanın, sorgu sonucunun, bağlı uygulamanın ya da web sayfasının senin izin verdiğinden fazlasını yapmasını, sırları okumasını, onayları atlamasını ya da denetim kaydından kaçmasını sağlayan her şey. Yukarıdaki sınırların anlatıldığından daha zayıf olduğunu gösteren bildirimler de memnuniyetle karşılanır.

Agentbits tek kişilik bir proje; yanıtlar elden geldiğince verilir. Hedef, bildirimin alındığını bir hafta içinde sana iletmek ve bir düzeltme ya da karar yayımlanana kadar seni bilgilendirmektir. İznin olursa sürüm notlarında adın anılır. Güvenlik düzeltmeleri yalnızca en son sürüme ve main dalına gelir.