跳到内容
光环标志
光环基地

认证

OAuth 具有 15 个提供商、TOTP MFA、魔术链接、通过电子邮件和短信发送的一次性代码以及基于角色的访问控制,来自单个 SDK。

说明7分钟 读取级别 中间修改于 2026年4月15日

该页面已自动翻译。英文版具有权威性。

aura-auth 的作用是什么#

aura-auth 服务为项目中的用户发出并验证 JWT。签名默认为 ES256,带有 项目派生的 秘密; 仅当配置了 RSA 密钥时才使用 RS256 (并公开 JWKS)——这是一个选择加入,而不是默认行为。它管理完整的生命周期:注册、电子邮件验证、MFA、刷新令牌轮换、服务器端撤销。

每个令牌嵌入 sub、 project_id、 role (anon 或 authenticated)、 email和一个 app_metadata 对象,该对象携带服务器端声明(tenant、 roles)。网关通过 request.jwt.claims将这些声明注入到 Postgres 连接中,使 RLS 策略可以直接访问 auth.uid()、 auth.role()、 auth.tenant()。

信息

用户表位于 project_{uuid}_auth: users、 oauth_accounts、 refresh_tokens、 mfa_factors、 sessions、 auth_audit_log。

三个演员,三个责任#

客户端签署质询,服务查询数据库,网关对每个后续请求进行验证。

登录流程text
# 1.客户端→aura-auth:凭证
POST /v1/auth/login  { email, password }

# 2. aura-auth:Argon2id 验证 + MFA 如果需要(状态保持 200)
if password OK && mfa_required  →  data = { mfa_required: true, mfa_token }
else                            →  data = { access_token, refresh_token, user, ... }

# 3.后续请求经过网关
apikey: <anon_key>   +   Authorization: Bearer <jwt>
gateway vérifie le JWT  →  claims injectés → Postgres RLS

八项机制准备就绪#

  • 电子邮件+密码。 Argon2id,可选电子邮件验证,安全轮换。
  • OAuth 2.1 · PKCE。 15 个提供商 — Google、GitHub、Apple、Microsoft、Discord、Twitter、Facebook、Bitbucket、Figma、Notion、Spotify、Twitch、Zoom、Kakao、Snapchat。
  • MFA TOTP。 Authy、1Password、谷歌身份验证器。后备短信。
  • 魔术链接和 OTP。 没有密码的电子邮件,i18n 模板,按地址进行速率限制。
  • 粒度 RBAC。 角色、权限、组织层次结构。自行生成 RLS 策略。
  • 会话绑定。 设备指纹、IP 检查、轮换刷新令牌。

四个流,一个 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 }
}
服务器端会话

在 Next.js App Router 中,始终在服务器操作和路由处理程序中使用 @aurabase/aurabase-js/ssr 中的 createServerClient 帮助程序。 cookie 刷新令牌是 httpOnly 并且永远不应该被客户端 JS 读取。

如果您没有使用SDK#

所有流也都在原始 REST 中公开,并具有相同的服务器端验证。请参阅 /docs/api-rest 了解完整列表。

方法端点描述
POST/v1/auth/register使用电子邮件和密码创建帐户
POST/v1/auth/login使用密码登录
GET/v1/auth/oauth/{provider}/start启动 OAuth 流 (PKCE)
POST/v1/auth/magic-link发送魔法链接
POST/v1/auth/email-otp/send通过电子邮件发送一次性代码
POST/v1/auth/mfa/setup注册 TOTP 因子
POST/v1/auth/refresh刷新令牌对
GET/v1/auth/me返回当前用户
GET/v1/auth/sessions列出活动会话
DELETE/v1/auth/sessions/{session_id}撤销会话
POST/v1/auth/logout结束当前会话

为了走得更远#