المصادقة
OAuth مع 15 موفرًا، وTOTP MFA، وروابط سحرية، ورموز لمرة واحدة عن طريق البريد الإلكتروني والرسائل النصية القصيرة، والتحكم في الوصول على أساس الدور، من SDK واحد.
ما تفعله الهالة#
تقوم خدمة aura-auth بإصدار JWTs للمستخدمين في المشروع والتحقق من صحتها. التوقيع هو ES256 بشكل افتراضي، مع سر مشتق من المشروع؛ يتم استخدام RS256 (والكشف عن JWKS) فقط في حالة تكوين مفتاح RSA - وهذا هو الاشتراك، وليس السلوك الافتراضي. فهو يدير دورة الحياة الكاملة: التسجيل، والتحقق من البريد الإلكتروني، MFA، وتدوير الرمز المميز، والإلغاء من جانب الخادم.
يتضمن كل رمز مميز sub و project_id و role (anon أو authenticated) و email وكائن app_metadata الذي يحمل مطالباتك من جانب الخادم (tenant, roles). تقوم البوابة بإدخال هذه المطالبات في اتصالات Postgres عبر request.jwt.claims، مما يجعل سياسات RLS متاحة مباشرة لـ auth.uid()، auth.role()، auth.tenant().
جداول المستخدم موجودة في project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
ثلاثة فاعلين، ثلاث مسؤوليات#
يوقع العميل على التحدي، وتقوم الخدمة بالاستعلام عن قاعدة البيانات، وتتحقق البوابة من صحة كل طلب لاحق.
# 1. العميل → مصادقة الهالة: بيانات الاعتماد
POST /v1/auth/login { email, password }
# 2. مصادقة الهالة: تحقق من Argon2id + MFA إذا لزم الأمر (تظل الحالة 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. تمر الطلبات اللاحقة عبر البوابة
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
ثماني آليات جاهزة#
- البريد الإلكتروني + كلمة المرور. Argon2id، التحقق الاختياري من البريد الإلكتروني، التدوير الآمن.
- OAuth 2.1 · PKCE. 15 مزودًا - Google، GitHub، Apple، Microsoft، Discord، Twitter، Facebook، Bitbucket، Figma، Notion، Spotify، Twitch، Zoom، Kakao، Snapchat.
- MFA TOTP. Authy، 1Password، Google Authenticator. الرسائل القصيرة الاحتياطية.
- الروابط السحرية وكلمة المرور لمرة واحدة (OTP). بريد إلكتروني بدون كلمة مرور، وقوالب i18n، والحد الأقصى للسعر حسب العنوان.
- RBAC الحبيبي. الأدوار والأذونات والتسلسلات الهرمية للمؤسسة. سياسات RLS التي تم إنشاؤها ذاتيًا.
- ربط الجلسة. بصمة الجهاز، فحص IP، الرموز المميزة لتحديث التدوير.
أربعة تيارات، 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 App Router، استخدم دائمًا المساعد createServerClient من @aurabase/aurabase-js/ssr في إجراءات الخادم ومعالجات المسار. رمز تحديث ملف تعريف الارتباط هو httpOnly ويجب ألا يقرأه العميل JS أبدًا.
إذا كنت لا تستخدم SDK#
يتم أيضًا عرض كافة التدفقات في REST الخام، مع نفس عمليات التحقق من جانب الخادم. راجع /docs/api-rest للحصول على القائمة الكاملة.
| الطريقة | نقطة النهاية | الوصف |
|---|---|---|
POST | /v1/auth/register | إنشاء حساب بالبريد الإلكتروني وكلمة المرور |
POST | /v1/auth/login | قم بتسجيل الدخول باستخدام كلمة المرور |
GET | /v1/auth/oauth/{provider}/start | بدء تدفق OAuth (PKCE) |
POST | /v1/auth/magic-link | إرسال رابط سحري |
POST | /v1/auth/email-otp/send | إرسال رمز لمرة واحدة عن طريق البريد الإلكتروني |
POST | /v1/auth/mfa/setup | تسجيل عامل TOTP |
POST | /v1/auth/refresh | قم بتحديث زوج الرمز المميز |
GET | /v1/auth/me | إرجاع المستخدم الحالي |
GET | /v1/auth/sessions | قائمة الجلسات النشطة |
DELETE | /v1/auth/sessions/{session_id} | إلغاء الجلسة |
POST | /v1/auth/logout | إنهاء الجلسة الحالية |