Saltar al contenido
Logotipo de Aurabase
aurabase

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.

Explicación7 min leerNivel intermedioRevisado el 15 abr 2026

Esta página fue traducida automáticamente. La versión en inglés es autorizada.

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

Información

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.

flujo de inicio de sesióntext
# 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#

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 }
}
Sesión del lado del servidor

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étodoPunto finalDescripción
POST/v1/auth/registerCrear una cuenta con correo electrónico y contraseña
POST/v1/auth/loginIniciar sesión con una contraseña
GET/v1/auth/oauth/{provider}/startIniciar un flujo OAuth (PKCE)
POST/v1/auth/magic-linkEnviar un enlace mágico
POST/v1/auth/email-otp/sendEnviar un código único por correo electrónico
POST/v1/auth/mfa/setupInscribir un factor TOTP
POST/v1/auth/refreshActualizar el par de tokens
GET/v1/auth/meDevolver el usuario actual
GET/v1/auth/sessionsListar sesiones activas
DELETE/v1/auth/sessions/{session_id}Revocar una sesión
POST/v1/auth/logoutFinalizar la sesión actual

para ir más lejos#