Uwierzytelnianie
OAuth z 15 dostawcami, TOTP MFA, magiczne linki, jednorazowe kody e-mailem i SMS-em oraz kontrola dostępu oparta na rolach z jednego pakietu SDK.
Co robi aura-auth#
Usługa aura-auth wystawia i sprawdza poprawność tokenów JWT dla użytkowników w projekcie. Podpis to domyślnie ES256 z kluczem tajnym pochodzącym z projektu; RS256 (i ujawnienie JWKS) jest używane tylko wtedy, gdy skonfigurowany jest klucz RSA — jest to zachowanie opcjonalne, a nie domyślne. Zarządza całym cyklem życia: rejestracją, weryfikacją adresu e-mail, MFA, rotacją odświeżania tokenów, unieważnianiem po stronie serwera.
Każdy token zawiera sub, project_id, role (anon lub authenticated), email i obiekt app_metadata, który przenosi żądania po stronie serwera (tenant, roles). Brama wstawia te oświadczenia do połączeń Postgres poprzez request.jwt.claims, dzięki czemu zasady RLS są bezpośrednio dostępne dla auth.uid(), auth.role(), auth.tenant().
Tabele użytkowników znajdują się w project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
Trzej aktorzy, trzy obowiązki#
Klient podpisuje wyzwanie, usługa wysyła zapytanie do bazy danych, bramka sprawdza poprawność przy każdym kolejnym żądaniu.
# 1. Klient → aura-auth: dane uwierzytelniające
POST /v1/auth/login { email, password }
# 2. aura-auth: weryfikacja Argon2id + MFA w razie potrzeby (status pozostaje 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. Kolejne żądania przechodzą przez bramę
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
Osiem mechanizmów gotowych#
- E-mail + hasło. Argon2id, opcjonalna weryfikacja e-mailem, bezpieczna rotacja.
- OAuth 2.1 · PKCE. 15 dostawców — Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
- MFA TOTP. Autoryzacja, 1 hasło, Google Authenticator. Awaryjny SMS.
- Magiczne linki i OTP. E-mail bez hasła, szablony i18n, limit szybkości według adresu.
- Granulowany RBAC. Role, uprawnienia, hierarchie organizacyjne. Samodzielnie wygenerowane zasady RLS.
- Powiązanie sesji. Odcisk palca urządzenia, sprawdzenie adresu IP, tokeny odświeżania rotacji.
Cztery strumienie, jeden 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 }
}
W routerze aplikacji Next.js zawsze używaj pomocy createServerClient z @aurabase/aurabase-js/ssr w akcjach serwera i procedurach obsługi tras. Token odświeżania pliku cookie to httpOnly i nigdy nie powinien być czytany przez klienta JS.
Jeśli nie używasz pakietu SDK#
Wszystkie przepływy są również udostępniane w nieprzetworzonym formacie REST z tą samą walidacją po stronie serwera. Pełną listę można znaleźć w /docs/api-rest.
| Metoda | Punkt końcowy | Opis |
|---|---|---|
POST | /v1/auth/register | Utwórz konto z adresem e-mail i hasłem |
POST | /v1/auth/login | Zaloguj się za pomocą hasła |
GET | /v1/auth/oauth/{provider}/start | Rozpocznij przepływ OAuth (PKCE) |
POST | /v1/auth/magic-link | Wyślij magiczny link |
POST | /v1/auth/email-otp/send | Wyślij jednorazowy kod e-mailem |
POST | /v1/auth/mfa/setup | Zarejestruj współczynnik TOTP |
POST | /v1/auth/refresh | Odśwież parę tokenów |
GET | /v1/auth/me | Zwróć bieżącego użytkownika |
GET | /v1/auth/sessions | Lista aktywnych sesji |
DELETE | /v1/auth/sessions/{session_id} | Odwołaj sesję |
POST | /v1/auth/logout | Zakończ bieżącą sesję |