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/authentication.md (or send Accept: text/markdown).
Kimlik doğrulama
Giriş yöntemleri, oturumlar ve hesap güvenliği.
Gerçek bir hesap oluşturun ve doğrulayın
Kimlik doğrulama, uygulamayı kimin kullandığını kanıtlamak anlamına gelir. Postgres'yi başlatın ve önce veritabanı kılavuzunu kullanarak geçişleri çalıştırın, ardından Web sunucusunu çalışır durumda bırakın. http://localhost:3000/auth,'yi açın, e-posta/şifre kaydı seçeneğini seçin, adınızı, e-posta adresinizi ve şifrenizi girin ve gönderin. EMAIL_PROVIDER=local'yi bu ilk test için saklayın.
Bir akış bir e-posta kodu istediğinde http://localhost:3000/mail-preview'yi başka bir tarayıcı sekmesinde açın, o adrese ilişkin en son iletiyi bulun ve kodunu tekrar oturum açma formuna kopyalayın. Süresi dolarsa yeni bir kod isteyin. Bu mesajlar yerel giden kutusunda kalır; harici bir gelen kutusunu tekrar tekrar kontrol etmek bunları bulamaz. Oturumu kapatın, ardından veritabanı destekli hesabın çalıştığını doğrulamak için tekrar oturum açın.
Kayıt sırasında bir veritabanı bağlantısı veya eksik tablo hatası bildirilirse, sosyal oturum açmayı etkinleştirmek yerine veritabanı kurulumunu tamamlayın. Google, GitHub, Apple, X ve Microsoft düğmelerinin kendi sağlayıcı uygulamasına ve geri arama ayarlarına ihtiyacı vardır; birini yalnızca sağlayıcı kılavuzu tamamlandıktan sonra etkinleştirin. Better Auth, gönderilen varsayılan motordur ve yerel e-postayla oturum açmak için ücretli bir kimlik doğrulama hesabına ihtiyaç duymaz.
Etkin giriş yöntemlerini seçin
Temel, e-posta/parola, OTP ve yapılandırılabilir sosyal kimlik doğrulamayı içerir. Better Auth kimliği ve oturumları sahiplenirken uygulama, sağlayıcı yapılandırmasını ve işlemsel OTP teslimini bir araya getirir.
Yalnızca yapılandırdığınız sosyal sağlayıcıları etkinleştirin. Sağlayıcı istemci sırları ve kimlik doğrulama sırrı sunucuda kalır.
Kimliği çalışma alanına bağlayın
Kimliği doğrulanmış işleyiciler, çalışma alanı kayıtlarına erişmeden önce oturum durumunu çözer. Çalışma alanı sağlama, yaşam döngüsü kancasını yeniden oynatmanın yinelenen sahiplik kayıtları oluşturmaması için idempotent kalmalıdır.
Oturum davranışını doğrulayın
Girişi, geçersiz ya da süresi dolmuş OTP'leri, tek kullanımlık tüketimi, çıkışı ve reddedilen anonim erişimi test edin. Bellek bağdaştırıcısı testleri işleyici semantiğini kapsar; üretim veritabanı kalıcılığı ve gerçek sağlayıcı geri çağrıları ayrı kabul gerektirir.
Kurulum ve yapılandırma
Better Auth varsayılan motordur (AUTH_PROVIDER=better-auth); üzerinde standardize olmak isteyen ekipler için bir Auth.js motoru mevcuttur. Etkin yöntemler sağlayıcı başına bildirilir: e-posta/parola, işlemsel postayla teslim edilen tek kullanımlık kodlar ve Google, Apple, GitHub, Microsoft ve Twitter için sosyal giriş.
Her sosyal sağlayıcı, kendi AUTH_<PROVIDER>_ENABLED bayrağı ve eşleşen istemci kimliği ile sırrıyla açılır. Kimlik doğrulama sırrı, sağlayıcı sırları ve oturum imzalama anahtarları yalnızca sunucu yapılandırmasıdır.
AUTH_PROVIDER=better-auth
AUTH_SECRET=generate-a-long-random-value
AUTH_GOOGLE_ENABLED=true
GOOGLE_CLIENT_ID=…
GOOGLE_CLIENT_SECRET=…Uygulama iş akışı
/auth yüzeyi yapılandırılmış yöntemleri işler; sunucu, auth-runtime içinde motoru bir araya getirir ve her korunan sınırda oturumu çözer. Başarılı ilk giriş, üyenin kişisel çalışma alanını idempotent olarak sağlar — yeniden oynatılan yaşam döngüsü kancaları asla ikinci bir sahiplik kaydı oluşturmamalıdır.
Hesap güvenliği /settings/security altında yaşar: parola değişikliği, etkin oturumlar ve derlemenin etkinleştirdiği yerlerde geçiş anahtarları. Oturum geri yükleme, çıkış iptali ve çalışma alanları arası reddi arayüz durumu olarak değil, sunucuda uygulanan davranış olarak tutun.
Doğrulama ve sorun giderme
Girişi, geçersiz ve süresi dolmuş OTP kodlarını, tek kullanımlık tüketimi, HTTPS kaynaklarında geçiş anahtarı törenlerini, sosyal geri çağrı dönüşlerini, çıkışı ve anonim reddi uygulayın. Geri çağrıları test etmeden önce her sağlayıcı yönlendirme URI'sini kaydedin ve iptal edilmiş bir oturumun korunan işi sürdüremediğini doğrulayın.