Ir para o conteúdo
Aura Logo
aurabase

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.

Explicação7 min lidoNível intermediárioRevisado em 15 de abr. de 2026

Esta página foi traduzida automaticamente. A versão em inglês é oficial.

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

Informações

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.

fluxo de logintext
# 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#

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 }
}
Sessão do lado do servidor

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étodoPonto finalDescrição
POST/v1/auth/registerCrie uma conta com e-mail e senha
POST/v1/auth/loginFaça login com uma senha
GET/v1/auth/oauth/{provider}/startIniciar um fluxo OAuth (PKCE)
POST/v1/auth/magic-linkEnvie um link mágico
POST/v1/auth/email-otp/sendEnvie um código único por e-mail
POST/v1/auth/mfa/setupRegistre um fator TOTP
POST/v1/auth/refreshAtualize o par de tokens
GET/v1/auth/meRetornar o usuário atual
GET/v1/auth/sessionsListar sessões ativas
DELETE/v1/auth/sessions/{session_id}Revogar uma sessão
POST/v1/auth/logoutEncerrar a sessão atual

Para ir mais longe#