सामग्री पर जाएँ
ऑराबेस लोगो
aurabase

प्रमाणीकरण

OAuth 15 प्रदाताओं के साथ, TOTP MFA, जादुई लिंक, ईमेल और एसएमएस द्वारा एक बार के कोड और एकल SDK से भूमिका-आधारित अभिगम नियंत्रण।

व्याख्या7 मि॰ पढ़ेंस्तर मध्यवर्ती15 अप्रैल 2026 पर संशोधित

यह पृष्ठ स्वचालित रूप से अनुवादित किया गया था. अंग्रेजी संस्करण प्रामाणिक है.

ऑरा-ऑथ क्या करता है#

aura-auth सेवा किसी प्रोजेक्ट में उपयोगकर्ताओं के लिए JWT जारी करती है और मान्य करती है। प्रोजेक्ट-व्युत्पन्न रहस्य के साथ हस्ताक्षर डिफ़ॉल्ट रूप से ES256 है; RS256 (और JWKS को उजागर करना) का उपयोग केवल तभी किया जाता है जब RSA कुंजी कॉन्फ़िगर की गई हो - यह एक ऑप्ट-इन है, डिफ़ॉल्ट व्यवहार नहीं। यह संपूर्ण जीवनचक्र का प्रबंधन करता है: पंजीकरण, ईमेल सत्यापन, MFA, ताज़ा टोकन रोटेशन, सर्वर-साइड निरस्तीकरण।

प्रत्येक टोकन में sub, project_id, role (anon या authenticated), email, और एक app_metadata ऑब्जेक्ट एम्बेड होता है जो आपके सर्वर-साइड दावों (tenant, roles) को वहन करता है। गेटवे इन दावों को request.jwt.claims के माध्यम से Postgres कनेक्शन में इंजेक्ट करता है, जिससे 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 · पीकेसीई। 15 प्रदाता - Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat।
  • MFA TOTP. ऑथी, 1पासवर्ड, गूगल प्रमाणक। फ़ॉलबैक एसएमएस.
  • मैजिक लिंक और ओटीपी। बिना पासवर्ड वाला ईमेल, i18n टेम्प्लेट, पते के अनुसार दर-सीमा।
  • दानेदार आरबीएसी। भूमिकाएँ, अनुमतियाँ, संगठन पदानुक्रम। स्व-निर्मित RLS नीतियां।
  • सत्र बाइंडिंग. डिवाइस फिंगरप्रिंट, आईपी जांच, रोटेशन रिफ्रेश टोकन।

चार स्ट्रीम, एक एसडीके#

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 ऐप राउटर में, सर्वर क्रियाओं और रूट हैंडलर में हमेशा @aurabase/aurabase-js/ssr से createServerClient हेल्पर का उपयोग करें। कुकी रीफ़्रेश टोकन httpOnly है और इसे क्लाइंट JS द्वारा कभी नहीं पढ़ा जाना चाहिए।

यदि आप SDK का उपयोग नहीं कर रहे हैं#

सभी प्रवाह समान सर्वर-साइड सत्यापन के साथ कच्चे REST में भी प्रदर्शित होते हैं। पूरी सूची के लिए /docs/api-rest देखें।

तरीकाendpointविवरण
POST/v1/auth/registerईमेल और पासवर्ड से एक खाता बनाएं
POST/v1/auth/loginपासवर्ड से साइन इन करें
GET/v1/auth/oauth/{provider}/startOAuth प्रवाह प्रारंभ करें (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वर्तमान सत्र समाप्त करें

आगे जाने के लिए#