İçeriğe geç
Aurabase Logosu
aura tabanı

Kimlik doğrulama

Tek bir SDK'dan 15 sağlayıcı, TOTP MFA, sihirli bağlantılar, e-posta ve SMS yoluyla tek seferlik kodlar ve rol tabanlı erişim kontrolü ile OAuth.

Açıklama7 dk. okuSeviye orta düzey15 Nis 2026 tarihinde revize edildi

Bu sayfa otomatik olarak çevrildi. İngilizce versiyonu yetkilidir.

aura-auth ne işe yarar?#

aura-auth hizmeti, bir projedeki kullanıcılar için JWT'leri yayınlar ve doğrular. İmza, projeden türetilmiş bir sır ile varsayılan olarak ES256 şeklindedir; RS256 (ve bir JWKS'yi açığa çıkarmak) yalnızca bir RSA anahtarı yapılandırılmışsa kullanılır; bu bir katılımdır, varsayılan davranış değildir. Tüm yaşam döngüsünü yönetir: kayıt, e-posta doğrulaması, MFA, jeton rotasyonunu yenileme, sunucu tarafı iptali.

Her belirteç, sub, project_id, role (anon veya authenticated), email ve sunucu tarafı taleplerinizi (tenant, roles) taşıyan bir app_metadata nesnesini içerir. Ağ geçidi bu talepleri request.jwt.claims aracılığıyla Postgres bağlantılarına enjekte ederek RLS ilkelerini auth.uid(), auth.role(), auth.tenant() için doğrudan erişilebilir hale getirir.

Bilgi

Kullanıcı tabloları project_{uuid}_auth'de bulunur: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.

Üç aktör, üç sorumluluk#

İstemci bir sorgulamayı imzalar, hizmet veritabanını sorgular, ağ geçidi sonraki her istekte doğrulama yapar.

oturum açma akışıtext
# 1. İstemci → aura-auth: kimlik bilgileri
POST /v1/auth/login  { email, password }

# 2. aura-auth: Argon2id doğrulama + MFA gerekirse (durum 200 olarak kalır)
if password OK && mfa_required  →  data = { mfa_required: true, mfa_token }
else                            →  data = { access_token, refresh_token, user, ... }

# 3. Sonraki istekler ağ geçidinden geçer
apikey: <anon_key>   +   Authorization: Bearer <jwt>
gateway vérifie le JWT  →  claims injectés → Postgres RLS

Sekiz mekanizma hazır#

  • E-posta + şifre. Argon2id, isteğe bağlı e-posta doğrulaması, güvenli rotasyon.
  • OAuth 2.1 · PKCE. 15 sağlayıcı — Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
  • MFA TOTP. Authy, 1Password, Google Kimlik Doğrulayıcı. Geri dönüş SMS'i.
  • Sihirli bağlantılar ve OTP. Şifresiz e-posta, i18n şablonları, adrese göre hız sınırı.
  • Parçalı RBAC. Roller, izinler, kuruluş hiyerarşileri. Kendi kendine oluşturulan RLS politikaları.
  • Oturum bağlama. Cihaz parmak izi, IP kontrolü, döndürme yenileme belirteçleri.

Dört akış, bir SDK#

app/actions/auth.tstypescript
'use server'
import { aura } from '@/lib/aurabase'

export async function signUp(email: string, password: string) {
  const { data, error } = await aura.auth.signUp({
    email,
    password,
    options: { emailRedirectTo: '/auth/callback' },
  })
  if (error) return { error }
  return { user: data.user }
}
Sunucu tarafı oturumu

Next.js Uygulama Yönlendiricisinde, sunucu eylemlerinde ve rota işleyicilerinde her zaman @aurabase/aurabase-js/ssr öğesindeki createServerClient yardımcısını kullanın. Çerez yenileme belirteci httpOnly'dir ve hiçbir zaman istemci JS tarafından okunmamalıdır.

SDK'yı kullanmıyorsanız#

Tüm akışlar aynı sunucu tarafı doğrulamalarıyla ham REST'te de kullanıma sunulur. Tam liste için /docs/api-rest'ye bakın.

YöntemUç noktaAçıklama
POST/v1/auth/registerE-posta ve şifreyle bir hesap oluşturun
POST/v1/auth/loginŞifreyle oturum açın
GET/v1/auth/oauth/{provider}/startBir OAuth akışı başlatın (PKCE)
POST/v1/auth/magic-linkSihirli bir bağlantı gönder
POST/v1/auth/email-otp/sendE-postayla tek seferlik kod gönder
POST/v1/auth/mfa/setupTOTP faktörünü kaydetme
POST/v1/auth/refreshBelirteç çiftini yenile
GET/v1/auth/meGeçerli kullanıcıyı döndür
GET/v1/auth/sessionsAktif oturumları listele
DELETE/v1/auth/sessions/{session_id}Oturumu iptal etme
POST/v1/auth/logoutGeçerli oturumu sonlandır

Daha ileri gitmek için#