Autenticación
OAuth con 15 proveedores, TOTP MFA, enlaces mágicos, códigos de un solo uso por correo electrónico y SMS y control de acceso basado en roles, desde un único SDK.
¿Qué hace aura-auth?#
El servicio aura-auth emite y valida JWT para los usuarios de un proyecto. La firma es ES256 de forma predeterminada, con un secreto derivado del proyecto; RS256 (y exponer un JWKS) solo se usa si se configura una clave RSA; este es un comportamiento opcional, no predeterminado. Gestiona el ciclo de vida completo: registro, verificación de correo electrónico, MFA, rotación de token de actualización, revocación del lado del servidor.
Cada token incorpora sub, project_id, role (anon o authenticated), email y un objeto app_metadata que lleva sus reclamos del lado del servidor (tenant, roles). La puerta de enlace inyecta estos reclamos en las conexiones Postgres a través de request.jwt.claims, lo que hace que las políticas RLS sean directamente accesibles para auth.uid(), auth.role(), auth.tenant().
Las tablas de usuario viven en project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
Tres actores, tres responsabilidades#
El cliente firma un desafío, el servicio consulta la base de datos, la puerta de enlace valida en cada solicitud posterior.
# 1. Cliente → aura-auth: credenciales
POST /v1/auth/login { email, password }
# 2. aura-auth: Argon2id verificar + MFA si es necesario (el estado sigue siendo 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. Las solicitudes posteriores pasan por la puerta de enlace.
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
Ocho mecanismos listos#
- Correo electrónico + contraseña. Argon2id, verificación de correo electrónico opcional, rotación segura.
- OAuth 2.1 · PKCE. 15 proveedores: Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
- MFA TOTP. Authy, 1Password, Autenticador de Google. SMS de reserva.
- Enlaces mágicos y OTP. Correo electrónico sin contraseña, plantillas i18n, tarifa-límite por dirección.
- RBAC granular. Roles, permisos, jerarquías organizativas. Políticas RLS autogeneradas.
- Enlace de sesión. Huella digital del dispositivo, verificación de IP, tokens de actualización de rotación.
Cuatro transmisiones, un 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 }
}
En Next.js App Router, utilice siempre el asistente createServerClient de @aurabase/aurabase-js/ssr en acciones del servidor y controladores de ruta. El token de actualización de cookies es httpOnly y el cliente JS nunca debe leerlo.
Si no estás utilizando el SDK#
Todos los flujos también se exponen en REST sin formato, con las mismas validaciones del lado del servidor. Consulte /docs/api-rest para obtener la lista completa.
| Método | Punto final | Descripción |
|---|---|---|
POST | /v1/auth/register | Crear una cuenta con correo electrónico y contraseña |
POST | /v1/auth/login | Iniciar sesión con una contraseña |
GET | /v1/auth/oauth/{provider}/start | Iniciar un flujo OAuth (PKCE) |
POST | /v1/auth/magic-link | Enviar un enlace mágico |
POST | /v1/auth/email-otp/send | Enviar un código único por correo electrónico |
POST | /v1/auth/mfa/setup | Inscribir un factor TOTP |
POST | /v1/auth/refresh | Actualizar el par de tokens |
GET | /v1/auth/me | Devolver el usuario actual |
GET | /v1/auth/sessions | Listar sesiones activas |
DELETE | /v1/auth/sessions/{session_id} | Revocar una sesión |
POST | /v1/auth/logout | Finalizar la sesión actual |