認証
15 のプロバイダーを備えた OAuth、 TOTP MFA、マジック リンク、電子メールと SMS によるワンタイム コード、およびロールベースのアクセス制御を 1 つの SDK から提供します。
aura-auth が行うこと#
aura-auth サービスは、プロジェクト内のユーザーに対して JWT を発行し、検証します。デフォルトでは、署名は ES256 で、プロジェクト由来のシークレットが含まれます。 RS256 (および JWKS の公開) は、RSA キーが構成されている場合にのみ使用されます。これはオプトインであり、デフォルトの動作ではありません。登録、電子メール検証、 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。
3 人の主体、3 つの責任#
クライアントはチャレンジに署名し、サービスはデータベースにクエリを実行し、ゲートウェイは後続の各リクエストを検証します。
# 1. クライアント → aura-auth: 認証情報
POST /v1/auth/login { email, password }
# 2. aura-auth: Argon2id verify + 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
8つのメカニズムを準備#
- 電子メール + パスワード。 Argon2id、オプションの電子メール検証、安全なローテーション。
- OAuth 2.1 · PKCE。 15 プロバイダー — Google、GitHub、Apple、Microsoft、Discord、Twitter、Facebook、Bitbucket、Figma、Notion、Spotify、Twitch、Zoom、Kakao、Snapchat。
- MFA 合計。 Authy、1Password、Google Authenticator。フォールバックSMS。
- マジック リンクと OTP。 パスワードなしの電子メール、i18n テンプレート、アドレスによるレート制限。
- 粒度の高い RBAC。 ロール、権限、組織階層。自己生成された RLS ポリシー。
- セッション バインディング。 デバイスのフィンガープリント、IP チェック、ローテーション リフレッシュ トークン。
4 つのストリーム、1 つの 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 }
}
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 | 現在のセッションを終了する |