Dokümanlar /
... / Kimlik Doğrulama ve Güvenlik / Kullanıcı Kimlik Doğrulama

🔐 Kimlik Doğrulama Temelleri

Odac.Auth servisi kapınızdaki güvenlik görevlisidir; kimin içeri gireceğini ve kimin dışarıda kalacağını yönetir. Kullanıcı giriş oturumlarını sizin yerinize halleder.

Kullanıcıyı İçeri Alma

Odac.Auth.login(userId, userData)

  • userId: Kullanıcı için benzersiz bir kimlik (veritabanı kimliği gibi).
  • userData: Kullanıcı adı veya rol gibi hatırlamak istediğiniz kullanıcı bilgilerini içeren bir nesne.

Bunu çağırdığınızda Auth, kullanıcı için güvenli bir oturum oluşturur.

💡 Kurumsal Güvenlik: ODAC her 15 dakikada bir Belirteç Döndürme işlemini otomatik olarak gerçekleştirir (yapılandırılabilir) ve tüm formlar için yerleşik CSRF koruması içerir. Oturumlar varsayılan olarak tarayıcı yeniden başlatmalarında kalıcıdır.

Davetli Listesini Kontrol Etme

  • await Odac.Auth.check(): Mevcut kullanıcı giriş yapmış mı? true veya false döndürür.
  • Odac.Auth.user(): Giriş yapmış kullanıcının tam kullanıcı nesnesini alır.
  • Odac.Auth.user('id'): Kullanıcı nesnesinden belirli bir alanı alır (ör. kimliğini).
  • Odac.Auth.token(): Belirteç tablosundan tam kimlik doğrulama oturum kaydını alır.
  • Odac.Auth.token('id'): Belirteç tablosundan kimlik doğrulama oturum kimliğini alır.

Kullanıcıyı Dışarı Uğurlama

  • Odac.Auth.logout(): Kullanıcının oturumunu sonlandırır ve çıkışını yapar.

Örnek: Bir Giriş Akışı

// Controller for your login form
module.exports = async function (Odac) {
    const { username, password } = Odac.Request.post

    const loginSuccess = await Odac.Auth.login({ username, password })

    if (loginSuccess) {
        return Odac.direct('/dashboard')
    } else {
        return Odac.direct('/login?error=1')
    }
}

// A protected dashboard page
module.exports = async function (Odac) {
    if (!await Odac.Auth.check()) {
        return Odac.direct('/login')
    }

    const username = Odac.Auth.user('username')
    const authId = Odac.Auth.token('id')  // Auth session ID from token table
    return `Welcome back, ${username}! (Session: ${authId})`
}