प्रमाणीकरण
OAuth 15 प्रदाताओं के साथ, TOTP MFA, जादुई लिंक, ईमेल और एसएमएस द्वारा एक बार के कोड और एकल SDK से भूमिका-आधारित अभिगम नियंत्रण।
ऑरा-ऑथ क्या करता है#
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 में रहती हैं।
तीन कलाकार, तीन ज़िम्मेदारियाँ#
ग्राहक एक चुनौती पर हस्ताक्षर करता है, सेवा डेटाबेस से पूछताछ करती है, गेटवे प्रत्येक बाद के अनुरोध पर सत्यापन करता है।
# 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 नीतियां।
- सत्र बाइंडिंग. डिवाइस फिंगरप्रिंट, आईपी जांच, रोटेशन रिफ्रेश टोकन।
चार स्ट्रीम, एक एसडीके#
'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}/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 | वर्तमान सत्र समाप्त करें |