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.
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.
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.
# 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#
'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 }
}
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öntem | Uç nokta | Açıklama |
|---|---|---|
POST | /v1/auth/register | E-posta ve şifreyle bir hesap oluşturun |
POST | /v1/auth/login | Şifreyle oturum açın |
GET | /v1/auth/oauth/{provider}/start | Bir OAuth akışı başlatın (PKCE) |
POST | /v1/auth/magic-link | Sihirli bir bağlantı gönder |
POST | /v1/auth/email-otp/send | E-postayla tek seferlik kod gönder |
POST | /v1/auth/mfa/setup | TOTP faktörünü kaydetme |
POST | /v1/auth/refresh | Belirteç çiftini yenile |
GET | /v1/auth/me | Geçerli kullanıcıyı döndür |
GET | /v1/auth/sessions | Aktif oturumları listele |
DELETE | /v1/auth/sessions/{session_id} | Oturumu iptal etme |
POST | /v1/auth/logout | Geçerli oturumu sonlandır |