Przejdź do treści
Logo Aurabase
aurabaza

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.

Objaśnienie7 min przeczytanePoziom mediatorZmieniono 15 kwi 2026

Ta strona została przetłumaczona automatycznie. Wersja angielska jest miarodajna.

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().

Informacje

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.

przepływ logowaniatext
# 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#

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 }
}
Sesja po stronie serwera

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.

MetodaPunkt końcowyOpis
POST/v1/auth/registerUtwórz konto z adresem e-mail i hasłem
POST/v1/auth/loginZaloguj się za pomocą hasła
GET/v1/auth/oauth/{provider}/startRozpocznij przepływ OAuth (PKCE)
POST/v1/auth/magic-linkWyślij magiczny link
POST/v1/auth/email-otp/sendWyślij jednorazowy kod e-mailem
POST/v1/auth/mfa/setupZarejestruj współczynnik TOTP
POST/v1/auth/refreshOdśwież parę tokenów
GET/v1/auth/meZwróć bieżącego użytkownika
GET/v1/auth/sessionsLista aktywnych sesji
DELETE/v1/auth/sessions/{session_id}Odwołaj sesję
POST/v1/auth/logoutZakończ bieżącą sesję

Aby pójść dalej#