Autenticação
OAuth com 15 provedores, TOTP MFA, links mágicos, códigos únicos por e-mail e SMS e controle de acesso baseado em funções, a partir de um único SDK.
O que aura-auth faz#
O serviço aura-auth emite e valida JWTs para usuários em um projeto. A assinatura é ES256 por padrão, com um segredo derivado do projeto; RS256 (e expor um JWKS) só é usado se uma chave RSA estiver configurada - este é um opt-in, não o comportamento padrão. Ele gerencia o ciclo de vida completo: registro, verificação de e-mail, MFA, rotação de token de atualização, revogação do lado do servidor.
Cada token incorpora sub, project_id, role (anon ou authenticated), email e um objeto app_metadata que carrega suas declarações do lado do servidor (tenant, roles). O gateway injeta essas declarações em conexões Postgres por meio de request.jwt.claims, tornando as políticas RLS diretamente acessíveis a auth.uid(), auth.role(), auth.tenant().
As tabelas do usuário residem em project_{uuid}_auth: users, oauth_accounts, refresh_tokens, mfa_factors, sessions, auth_audit_log.
Três atores, três responsabilidades#
O cliente assina um desafio, o serviço consulta o banco de dados, o gateway valida em cada solicitação subsequente.
# 1. Cliente → aura-auth: credenciais
POST /v1/auth/login { email, password }
# 2. aura-auth: verificação de Argon2id + MFA se necessário (o status permanece 200)
if password OK && mfa_required → data = { mfa_required: true, mfa_token }
else → data = { access_token, refresh_token, user, ... }
# 3. As solicitações subsequentes passam pelo gateway
apikey: <anon_key> + Authorization: Bearer <jwt>
gateway vérifie le JWT → claims injectés → Postgres RLS
Oito mecanismos prontos#
- E-mail + senha. Argon2id, verificação de e-mail opcional, rotação segura.
- OAuth 2.1 · PKCE. 15 provedores – Google, GitHub, Apple, Microsoft, Discord, Twitter, Facebook, Bitbucket, Figma, Notion, Spotify, Twitch, Zoom, Kakao, Snapchat.
- MFA TOTP. Authy, 1Password, Autenticador Google. SMS alternativo.
- Links mágicos e OTP. Email sem senha, modelos i18n, limite de taxa por endereço.
- RBAC granular. Funções, permissões, hierarquias organizacionais. Políticas RLS autogeradas.
- Ligação de sessão. Impressão digital do dispositivo, verificação de IP, tokens de atualização de rotação.
Quatro fluxos, um 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 }
}
No Next.js App Router, sempre use o auxiliar createServerClient de @aurabase/aurabase-js/ssr em ações do servidor e manipuladores de rota. O token de atualização do cookie é httpOnly e nunca deve ser lido pelo cliente JS.
Se você não estiver usando o SDK#
Todos os fluxos também são expostos em REST bruto, com as mesmas validações do lado do servidor. Consulte /docs/api-rest para obter a lista completa.
| Método | Ponto final | Descrição |
|---|---|---|
POST | /v1/auth/register | Crie uma conta com e-mail e senha |
POST | /v1/auth/login | Faça login com uma senha |
GET | /v1/auth/oauth/{provider}/start | Iniciar um fluxo OAuth (PKCE) |
POST | /v1/auth/magic-link | Envie um link mágico |
POST | /v1/auth/email-otp/send | Envie um código único por e-mail |
POST | /v1/auth/mfa/setup | Registre um fator TOTP |
POST | /v1/auth/refresh | Atualize o par de tokens |
GET | /v1/auth/me | Retornar o usuário atual |
GET | /v1/auth/sessions | Listar sessões ativas |
DELETE | /v1/auth/sessions/{session_id} | Revogar uma sessão |
POST | /v1/auth/logout | Encerrar a sessão atual |