For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /tr/docs/web/security.md (or send Accept: text/markdown).
Güvenlik ve gizlilik
Hız sınırları, sırlar, veri dışa aktarma ve denetim izi.
Başlangıç seviyesinde izlenecek yol
Önkoşullar: Aşağıdaki iki başlangıç kılavuzunu okuyun, Web yerel kurulumunu tamamlayın ve bu monorepo'yu düzenleyicinizde kökünden açın. Web ayarları apps/web/.env.local'ye aittir; Next.js, .env kökünü okumaz. Varsayılan sahte modda /dashboard, veritabanı olmayan bir demodur; /auth'nin taşınan bir veritabanına ihtiyacı var.
Kısa terimler: Çalışma alanı, bir ekibin ayrı kullanıcıları, verileri ve ayarlarıdır. Sunucu güvenilir arka uçtur; sağlayıcı anahtarlarını tarayıcı ve telefon kodundan uzak tutun. Geçiş, tabloları oluşturan veya güncelleyen sürümlü bir veritabanı değişikliğidir. Yapay zeka modeli yanıt veren motordur; model kataloğu, sunucunun mevcut model kimlikleri ve fiyatlarının listesidir. Sağlayıcı yapay zeka, e-posta veya faturalandırma hizmeti gibi bir dış hizmettir. Yetki, bir çalışma alanının bir özelliği kullanmasına olanak tanıyan bir yetkidir. Web kancası, bir hizmetin başka bir hizmetin URL'sine gönderdiği bir mesajdır.
1. Kullanıcıya ait bir kaydı okuyan sunucu eyleminde veya rotada, sorgulamadan önce oturum açmış kullanıcının üyeliğini ve aktif workspaceId'yi çözümleyin.
2. Temsilcinizden, tam kayıt yolu için bir izin verilen üye vakası ve bir yabancı çalışma alanı reddi eklemesini isteyin; İlgili rolleri ve alanları sağlayın.
3. İlk istek başarılı olmalı ve ikincisi hiçbir kayıt/erişim reddedilmemelidir. Yalnızca düğmeyi değiştirmek erişimi gizler ancak doğrudan istekler hâlâ çalışıyorsa sunucu sınırı eksiktir.
Özel kod için, sağlanan prompts/README.md ile başlayın ve en yakın istemi kopyalayın: Bir uygulama ekranı için prompts/new-app-screen.md veya genel bir sayfa için prompts/new-landing-page.md. Sunucu, veritabanı veya sağlayıcı çalışması için kodlama temsilcinize bu kılavuzun görevini verin ve ondan AGENTS.md, .ai/PROJECT_CONTEXT.md ve eşleşen .ai/ aynalarını okumasını isteyin; burada adı geçen kaynak dosyaların tamamını inceleyin; düzenlemeden önce dosyaları ve kontrolleri listeleyin; çalışma alanı sahipliğini ve yalnızca sunucuya ait sırları koruyun; ve size farkı göstereceğim. İstediğiniz davranışı, giriş ve çıkış alanlarını, izin verilen rolleri, beklenen başarıyı ve hataları ve test hesabını, sağlayıcıyı veya cihazı ona bildirin. Örnek değerleri kullanın; asla gerçek bir sırrı yapıştırmayın.
Verilerden önce üyeliği çözümleyin
Oturum kimliği seçer; sunucu aktif çalışma alanını çözümler ve üyeliği/rolü doğrular. Kullanıcıya ait her kayıt workspaceId kullanır. Bir istemci alanı, URL kimliği veya model tarafından seçilen bağımsız değişken bu sahiplik kontrolünün yerini alamaz.
Platform pazarlama varlıkları ve platform yöneticisi kayıtları açık platform kapsamına sahiptir; anonim bekleme listesi girişleri için bir çalışma alanı icat etmeyin.
Asenkron çalışmayla sınırı taşıyın
Görevler, işler, araç bağlamı, API anahtarları, içerik, depolama ve giden olaylar, kimliği doğrulanmış çalışma alanını devralır. Kaynak kimliklerini sahiplikle birlikte kontrol edin. Başka bir çalışma alanından geçerli bir kimliğe izin vermek hâlâ bir yetkilendirme hatasıdır.
Önce inkar testlerini yazın
Her başarılı mutasyonu/okumayı anonim, yabancı çalışma alanı ve yetersiz rol testleriyle eşleştirin. Yasaklanmış bir sonucu teşhis ederken asla sırları ifşa etmeyin.
Kurulum ve yapılandırma
rate-limit-runtime, kimlik doğrulama, checkout, API ve gönderim rotalarına bağlı paylaşılan sınırlayıcıyı sağlar — rota başına sayaçlar icat etmek yerine yeni istismara açık uç noktalara genişletin. Oturum yapılandırması, yalnızca HTTPS çerezleri ve sağlayıcı sırları sunucu tarafında kalır.
Çalışma alanı denetim kayıtları (audit-runtime.ts) güvenlikle ilgili değişiklikleri yakalar — sağlayıcı yapılandırması, üye ve rol güncellemeleri — ve /settings/audit altında okunabilir.
# Data subject export
src/data-export.ts — assembles a member's
workspace-owned records for account exportUygulama iş akışı
Kimlik bilgilerini günlüklerden, hata yüklerinden, analitik özelliklerinden ve denetim değerlerinden uzak tutun — gözlemlenebilirlik katmanı bilinen anahtarları gizler ama serbest biçimli metin yazarın sorumluluğudur. Her okuma ve yazma için yetkilendirmeyi sunucuda çözün; arayüz durumu sunuştur, kanıt değil.
Hesap verisi dışa aktarma ve silme istekleri hesap sınırı üzerinden çalışır, böylece aynı sahiplik kuralları geçerli olur. Yalnızca ürünün ihtiyaç duyduğu veriyi saklayın.
Doğrulama ve sorun giderme
Sınırlayıcıyı yeniden denenebilir 429 döndürene kadar uygulayın, üretmesi gereken mutasyonlar için denetim satırlarının göründüğünü doğrulayın ve test üyesinin verisini dışa aktarın. Sürüm başına bir çalışma alanları arası okuma yoklayın — önemli olan en ucuz regresyon.