认证
OAuth 具有 15 个提供商、TOTP MFA、魔术链接、通过电子邮件和短信发送的一次性代码以及基于角色的访问控制,来自单个 SDK。
该页面已自动翻译。英文版具有权威性。
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#
typescript
'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 | 结束当前会话 |