# Kimlik Doğrulama & Mind Key'ler
SUMMARY: Synapse kimlik doğrulaması nasıl çalışır: ajanlar için Mind Key, insanlar için JWT, ?key= varsayılan olarak devre dışı (yalnızca Bearer, AUTH_QUERY_KEY_MODE=deny).

KEY CONTEXT:
Two auth methods: Mind Key (token-scoped, never expires) and JWT (user-scoped, 7-day expiry).
Mind Key: Authorization: Bearer mk_xxx (?key= DISABLED by default — AUTH_QUERY_KEY_MODE=deny hardened default; 401 + hint on ?key=)
JWT: Authorization: Bearer eyJ... (120 req/min external IPs, unlimited internal; used for /register, /login, /minds, /sharing)
Mind Key is shown only once at creation. Store it permanently.
Each mind has exactly one Mind Key. Multiple minds = multiple keys.

Kimlik Doğrulama & Mind Key'ler
Synapse, her biri farklı bir kullanım senaryosu için optimize edilmiş iki kimlik doğrulama yöntemi kullanır. Güvenilir entegrasyonlar oluşturmak için farkı anlamak esastır.
İki Kimlik Doğrulama Yöntemi
| Yöntem | Kullanım Senaryosu | Hız Sınırı | Son Kullanma |
|--------|----------|------------|--------|
| Mind Key | LLM ajanları, otomatik araçlar | 120/dk (dış Bearer); ?key= varsayılan olarak devre dışı (deny) | Asla |
| JWT | İnsana yönelik arayüz, hesap işlemleri | 120/dk (harici IP'ler) | 7 gün |
Mind Key (Ajanlar için)
Mind Key, kiracı kapsamlı bir API token'ıdır. Tek bir mind'in verilerini (bellekler, görevler, sohbet, betikler vb.) doğrular. Şunlar için kullanın:
- API çağrısı yapan LLM ajanları
- Arka plan otomasyon betikleri
- MCP sunucu yapılandırması
- Herhangi bir uzun ömürlü entegrasyon
Header kimlik doğrulaması (önerilir)
[CODE BLOCK]
Sorgu parametresi (varsayılan olarak devre dışı)
[CODE BLOCK]
> [!WARNING]
>  sorgu parametresi, sıkılaştırılmış varsayılan  ile devre dışıdır:
> sunucu  isteğine 401 ve ipucu "Query-param auth (?key=) is disabled" ile yanıt verir. Yalnızca Bearer güvenli varsayılandır
> (SSOT: ). Yalnızca bir operatör açıkça  ayarladığında
>  60 istek/dk (IP başına) geçiş vanası olarak çalışır. Dış Bearer istemcileri kimlik başına
> 120 istek/dk alır; güvenilen dahili ağlar sınırsızdır. İstemciniz özel başlıkları desteklediğinde header'ı kullanın.
Mind Key Oluşturma
[CODE BLOCK]
Yanıt  içerir — hemen kaydedin, yalnızca bir kez gösterilir.
Mind'lerinizi listeleme
[CODE BLOCK]
Bir mind'i silme (geri alınamaz!)
[CODE BLOCK]
JWT (İnsanlar için)
JWT'ler belirli bir mind'i değil, kullanıcı hesabını doğrular. Şunlar için kullanın:
- Hesap kaydı ve giriş
- Mind oluşturma / listeleme / silme
- Mind'leri diğer kullanıcılarla paylaşma
- Web Push abonelik yönetimi
Kaydol
[CODE BLOCK]
Döndürür: 
Giriş
[CODE BLOCK]
Döndürür: 
JWT son kullanma
JWT'ler 7 gün sonra sona erer. Bir JWT sona erdiğinde, yenisini almak için  çağırın. Mind Key asla sona ermez, bu yüzden mevcut ajan entegrasyonları çalışmaya devam eder.
Güvenlik En İyi Uygulamaları
> [!CRITICAL]
> - Mind Key'leri asla git'e commit etmeyin. Ortam değişkenleri kullanın.
> - Mind Key'leri asla loglamayın. Loglarda maskeleyin ().
> - Bir sızıntıdan şüphelenirseniz anahtarları döndürün (mind'i silin, yeni oluşturun).
> - Bir anahtar sızarsa etki alanını sınırlamak için proje başına bir mind kullanın.
Ortam değişkeni deseni
[CODE BLOCK]
[CODE BLOCK]
MCP sunucu yapılandırması
[CODE BLOCK]
Çoklu Mind Deseni
Her kullanıcı birden çok mind'e sahip olabilir. Yaygın desenler:
| Mind Adı | Amaç |
|-----------|---------|
|  | İşle ilgili bellekler |
|  | Kişisel tercihler, aile |
|  | Belirli proje bağlamı |
|  | Öğrenme ilerlemesi |
|  | Genel amaçlı yedek |
Bağlamları izole tutmak için farklı LLM oturumlarında farklı Mind Key'ler kullanın.
Hız Sınırları
| Kimlik Doğrulama Yöntemi | Sınır | Kapsam |
|-------------|-------|-------|
| Mind Key (header) | 120/dk harici IP'lerden (kimlik başına); güvenilen iç ağlar için sınırsız | Mind başına |
| Mind Key (?key=, yalnızca allow ile) | 60/dakika | IP başına |
| JWT (header) | 120 istek/dk (harici IP'ler; güvenilen iç ağlar için sınırsız) | Kullanıcı başına |
| Herkese açık uç noktalar | Yok | Global |
Hız sınırı başlıkları (, , ) uygun olduğunda yanıtlara dahil edilir.
Sonraki Adımlar
- Mind Key ve JWT — hangisi ne zaman kullanılır
- Memory API — bir Mind Key ile neler yapabilirsiniz
- User API — JWT'lerle hesap yönetimi