Gizli Bilgilerin İşletim Sistemi Anahtar Zincirinde Yaşar,
Bir Prompt'ta ya da Deponda Değil
AgentsRoom; API anahtarlarını, token'ları ve veritabanı parolalarını işletim sistemi anahtar zincirinle şifrelenmiş, yalnızca makinende duran bir kasada saklar. Sen onlara adlarıyla referans verirsin, bir komut ya da bir ajan başladığında değeri uygulama çözümler.
Bir ajanın önünü açmanın en hızlı yolu olduğu için token'ı prompt'a yapıştırmayı bırak. Gizli bilgiyi bir kez adlandır, başka her yerde {{secret:NAME}} kullan, değer de ait olduğu yerde kalsın.
AgentsRoom bir gizli bilgiyi komutların için nasıl kullanılabilir, onu isteyen ajan için nasıl okunamaz tutuyor.
Her projede sonunda paylaşılmaması gereken birkaç değer birikir : bir ödeme anahtarı, bir veritabanı parolası, bir dağıtım token'ı, test ortamı için bir API anahtarı. Yapay zeka kodlama ajanları işin içine girdiği anda bu değerler mümkün olan en kötü biçimde dolaşmaya başlar. Bir ajanın önünü açmak için prompt'a yapıştırılır, ajanın yazdığı bir betiğe gömülür ya da üç commit sonra depoya giren bir dosyaya düşer.
AgentsRoom gizli bilgi yöneticisi onlara tek bir yaşam alanı verir. Bir gizli bilgi bir addan ve bir değerden ibarettir : onu bir kez eklersin, AgentsRoom da diske dokunmadan önce işletim sistemi anahtar zincirinle şifreler. Kasanın tamamı, ana klasöründe yalnızca sahibine açık izinlerle yazılan tek bir dosyadır ve oluşturulduğu makineden asla çıkmaz.
O andan sonra değeri bir daha eline almazsın. Bir dev komutuna ya da bir ajan ortamına {{secret:NAME}} yazarsın, AgentsRoom da o komut veya o ajan başlarken gerçek değeri yerine koyar. Ajanların adları listeleyebilir ve birinin enjekte edilmesini isteyebilir, işlerini yapmaya bu yeter, değerin kendisini ise hiçbir zaman almazlar.
Yapay Zeka Ajanlarıyla Dolu Bir Makine İçin Tasarlanmış Kasa
İşletim sistemi tarafından şifrelenir, adıyla çağrılır, mümkün olan en son anda çözümlenir.
İşletim Sistemi Anahtar Zincirinle Şifreli
Her değer Electron safeStorage üzerinden şifrelenir; yani şifreleme anahtarını AgentsRoom değil, işletim sistemi anahtar zincirin tutar. Uygulama şifreli metni saklar ve çözmesini sistemden ister, tıpkı kimlik bilgilerini zaten emanet ettiğin diğer uygulamalar gibi.
Tek Kasa Dosyası, Yalnızca Sahibine Açık
Bütün gizli bilgilerin ~/.agentsroom/secrets.json içindeki tek bir kasada yaşar, yalnızca sahibine açık izinlerle (0600) yazılır ve her değişiklikte atomik olarak değiştirilir. Bir çökme sonrasında yarım yazılmış dosya kalmaz ve makinedeki başka hiçbir kullanıcı hesabı onu açamaz.
Değerle Değil, Adla Referans Ver
Kaydedilmiş bir gizli bilgi {{secret:NAME}} olarak kullanılır : bir dev terminalinin komut satırında, bir ajana verilen ortamda, kimlik bilgisini başka türlü yazacağın her yerde. Ekranda okuduğun ve bir ekip arkadaşına gösterebileceğin şey addır.
Başlatma Anında, Ana Süreçte Çözümlenir
Yerine koyma, süreç başlarken Electron ana sürecinin içinde gerçekleşir. Çözümlenen değer başlatılan komutun ortamına gider, başka hiçbir yere : bir log'a değil, arayüze değil, diskteki bir dosyaya değil.
Ajanlar Adları Görür, Değerleri Değil
Bir yapay zeka ajanı gizli bilgilerinin adlarını listeleyebilir ve birinin, çalıştırmak üzere olduğu şeye enjekte edilmesini isteyebilir. Bir değeri ajana, arayüz katmanına ya da MCP üzerinden geri veren hiçbir kod yolu yoktur. Ajan referansla çalışır, uygulama gizli bilgiyle.
Anahtar Zinciri Yoksa Saklama da Yok
Makine çalışan bir işletim sistemi anahtar zinciri sunamıyorsa AgentsRoom, düz metne geri dönmek yerine gizli bilgiyi kaydetmeyi reddeder. Sessizce sıradan bir dosyaya dönüşen bir kasa, hiç kasa olmamasından kötüdür, bu yüzden böyle bir geri dönüş yolu yok.
Tasarım Gereği Makinende, Bir Ayarın Varsayılanı Sayesinde Değil
Gizli bilgilerin AgentsRoom sunucularına asla gönderilmez. Kontrol edilecek bir senkronizasyon anahtarı, vazgeçmen gereken bir bulut kasası ve anahtarlarının kendi diskin dışında bir yedeği yoktur. Kasa makinede oluşturulur, işletim sistemi anahtar zincirinin o makine için tuttuğu bir anahtarla şifrelenir ve orada kalır. Dosyanın tek başına bir kopyası, başka bir makinenin açabileceği bir şey değildir.
Bir gizli bilgiyi kullanmakla okumak arasındaki ayrım, bir prompt'a yazılmış talimatla değil, kodla zorunlu kılınır. Arayüz katmanı, MCP araçları ve her ajan gizli bilgilerden adlarıyla söz eder. Bir referansı değere çeviren tek yer Electron ana sürecidir: bunu senin başlatmasını istediğin bir sürecin ortamını hazırlarken yapar ya da bir projede HTML görünümleri için canlı veriyi açtıysan, izin verdiğin bir uç noktaya giden isteğe sayfanın hiç görmediği bir başlık eklerken yapar. Bir ajana kimlik bilgilerine dikkat etmesini söylemek bir umuttur. Kimlik bilgisini döndüren bir fonksiyonun hiç bulunmaması ise bir garantidir.
Bir ajanın ücretli bir API'ye ya da gerçek bir veritabanına karşı çalışmasına izin vermeyi makul kılan şey budur. Ajan, STRIPE_SECRET_KEY adında bir gizli bilginin var olduğunu bilir ve çalıştırmak istediği komuta enjekte edilmesini isteyebilir. Onu ekrana yazdıramaz, yazmakta olduğu bir dosyaya kopyalayamaz ve başka bir yerde saklanan bir konuşmaya sızdıramaz.
Yapıştırılan Bir Token'dan Adlandırılmış Bir Gizli Bilgiye
Üç adım, ve değer bir daha ortaya çıkmaz.
Gizli bilgiyi bir kez ekle
Ona bir ad ver ve değeri son bir kez yapıştır. AgentsRoom onu işletim sistemi anahtar zinciriyle şifreler ve ~/.agentsroom/secrets.json içindeki kasaya, yalnızca sahibine açık izinlerle ve atomik olarak yazar. Makinede kullanılabilir bir anahtar zinciri yoksa uygulama bunu söyler ve düz metin yazmak yerine reddeder.
{{secret:NAME}} olarak referans ver
Referansı, değerin eskiden gittiği her yerde kullan : dev sunucunu başlatan komutta ya da bir API token'ına ihtiyaç duyan bir ajanın ortamında. Ayarlarında saklanan şey referanstır ve ona bakmak güvenlidir.
Başlatma anında AgentsRoom çözümlesin
Komut ya da ajan başladığında ana süreç, o sürecin ortamında referansı gerçek değerle takas eder. Araç zincirin ihtiyacı olanı alır, onu süren ajan ise yine yalnızca adı bilmiş olur.
Bir Gizli Bilgi Yöneticisi Ne Zaman Tercih Olmaktan Çıkar
Yapıştırılan bir kimlik bilgisinin gerçek bir olaya dönüştüğü durumlar.
Gerçek anahtar isteyen dev sunucuları
Dev sunucun bir ödeme anahtarı ve bir veritabanı parolası olmadan açılmaz. Kimlik bilgisi yerine başlatma komutuna {{secret:NAME}} koy, komut da bir görüşme sırasında ekranda bırakabileceğin, bir an bile panik yaşatmayan bir şeye dönüşsün.
Ücretli bir API çağıran ajanlar
Bir ajanın, çalışırken üçüncü taraf bir API'ye ulaşmak için bir token'a ihtiyacı var. Gizli bilgiyi ortamına adıyla ekle : ajan çalışan bir ortam alır, token ise ne prompt'ta, ne konuşmada, ne de ajanın sonrasında yazdığı şeylerde olur.
Depoya düşmeyi bırakan anahtarlar
Alışıldık kaza, sonraki bir commit'in toparladığı bir yapılandırma dosyasına yazılmış kimlik bilgisidir. Gizli bilgilere adla referans vermek, depoda izlenen dosyanın yalnızca bir ad tuttuğu anlamına gelir, böylece dal push edildiğinde sızacak bir şey kalmaz.
Tek makine, çok proje
İşletim sistemi anahtar zincirinle korunan ve yalnızca kendi kullanıcı hesabının okuyabildiği tek bir kasa, açtığın her projeye hizmet eder. Her proje ihtiyacı olan adlara referans verir ve hiçbiri kimlik bilgisinin kendine ait dağınık bir kopyasını tutmaz.
Bir ajan okuyamadığı bir gizli bilgiyi nasıl kullanabilir?
Çünkü bir kimlik bilgisini kullanmakla okumak iki farklı işlemdir ve AgentsRoom ajanlar için yalnızca ilkini uygular. Kasa, MCP üzerinden tam olarak tek bir araçla, secrets_list ile sunulur ve bu araç adları döndürür. Oradan sonra ajan, ihtiyaç duyduğu komuta ya da ortama {{secret:NAME}} yazar ve yerine koymayı ajan değil, uygulama yapar.
Bilinçli olarak eksik bırakılan şey diğer yöndür. Hiçbir MCP aracı bir gizli bilgi değeri döndürmez, arayüz katmanı hiçbir zaman bir değer almaz ve hiçbir şey onu bir konuşmaya geri yazmaz. Bir referansı gerçek değere çevirmek, bir süreç başlatıldığı anda Electron ana sürecinin içinde olur ve sonuç o sürecin ortamına gider, başka hiçbir yere. Tek istisna isteğe bağlıdır ve proje başınadır: HTML görünümlerin için izin verdiğin bir uç noktaya giden istek başlığı; ana süreç ekler ve sayfaya asla gösterilmez.
Pratikteki sonuç şudur : bir ajan, bağlamına tek bir kimlik bilgisi girmeden test paketini gerçek bir veritabanına karşı çalıştırabilir, ücretli bir API'yi çağırabilir ya da test ortamına dağıtım yapabilir. Sonradan gizlenecek bir şey yok, çünkü hiçbir zaman açığa çıkan bir şey olmadı.
AgentsRoom MCP'yi keşfetSıkça Sorulan Sorular
Bize başka bir şey sorGizli bilgilerim nerede saklanıyor?
Yapay zeka ajanım gizli bilgilerimi okuyabilir mi?
Gizli bilgilerim AgentsRoom sunucularına senkronize ediliyor mu?
Bir komutta gizli bilgiyi nasıl kullanırım?
Makinemde işletim sistemi anahtar zinciri yoksa ne olur?
Bu, projemdeki ortam dosyalarının yerini alır mı?
Birisi kasa dosyasını kopyalarsa okuyabilir mi?
Ajanlarım gizli bilgiler için hangi MCP aracını kullanır?
Bunları da beğenebilirsin
Veritabanı Bağlantıları
MySQL, PostgreSQL, SQL Server, MongoDB, SQLite ve Google BigQuery bağlantılarını kaydet, özel bir alt ağdaki veritabanına bir SSH tüneli ya da bir AWS SSM oturumu üzerinden ulaş ve yapay zeka ajanların onu MCP üzerinden sorgulasın. Varsayılan olarak salt okunur, çağrı başına tek ifade, sınırlandırılmış sonuç kümeleri ve parola ajana asla ulaşmaz. MySQL, PostgreSQL ve MongoDB için dışa aktarma, içe aktarma ve veritabanından veritabanına kopyalama.
SSH Bağlantıları
SSH bağlantılarını kaydet, SSH üzerinden yerleşik bir terminal aç ve Claude Code, Codex veya Antigravity CLI'yi doğrudan uzak sunucunda ya da VPS'inde çalıştır. SSH anahtarı veya parola ile kimlik doğrulama, proje bazlı bağlantı profilleri, ayrı bir SSH istemcisine gerek yok.
Dev Terminalleri
Proje bazlı terminal yöneticisi ve süreç başlatıcı. Backend, frontend ve worker'ları tek tıkla başlat, gizli bilgilerin elle yazılmak yerine başlatma anında enjekte edilsin.
AgentsRoom MCP
Ajanlarının AgentsRoom'un kendisini yönlendirmesini sağlayan MCP sunucusu : projeler, terminaller, backlog ve bağlantılar, beraberinde gelen koruma önlemleriyle.
Ajanlarına Erişim Ver, Anahtarlarını Değil
AgentsRoom'u indir, API anahtarlarını ve parolalarını işletim sistemi anahtar zincirinle şifrelenen bir kasaya taşı ve başka her yerde onlara adlarıyla referans ver.
Yardımcı uygulama: hareket halindeyken ajanlarını izle
Claude, Codex, Antigravity CLI veya başka bir AI sağlayıcı kullan.
Hataları ve istekleri doğrudan genel backloguna gönder.
Bir sohbet gibi okuduğun ajanlar
Her ajanın bir rolü, bir yüzü ve mesajlaşma uygulaması gibi okuduğun bir konuşması var.
