انتقل إلى المحتوى
شعار أوراباسي
aurabase

المصادقة

OAuth مع 15 موفرًا، وTOTP MFA، وروابط سحرية، ورموز لمرة واحدة عن طريق البريد الإلكتروني والرسائل النصية القصيرة، والتحكم في الوصول على أساس الدور، من SDK واحد.

شرح7 د قراءةالمستوى وسيطةتمت المراجعة في 15‏/04‏/2026

تمت ترجمة هذه الصفحة تلقائيًا. النسخة الإنجليزية موثوقة.

ما تفعله الهالة#

تقوم خدمة 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.

ثلاثة فاعلين، ثلاث مسؤوليات#

يوقع العميل على التحدي، وتقوم الخدمة بالاستعلام عن قاعدة البيانات، وتتحقق البوابة من صحة كل طلب لاحق.

تدفق تسجيل الدخولtext
# 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 واحد#

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 }
}
جلسة من جانب الخادم

في 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إنهاء الجلسة الحالية

للذهاب أبعد من ذلك#