コンテンツへスキップ
オーラベースのロゴ
オーラベース

認証

15 のプロバイダーを備えた OAuth、 TOTP MFA、マジック リンク、電子メールと SMS によるワンタイム コード、およびロールベースのアクセス制御を 1 つの SDK から提供します。

解説7 分 読み取りレベル 中間2026/04/15 に改訂

このページは自動翻訳されました。英語版が正式です。

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 つの責任#

クライアントはチャレンジに署名し、サービスはデータベースにクエリを実行し、ゲートウェイは後続の各リクエストを検証します。

サインインの流れtext
# 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#

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}/startOAuth フロー (PKCE) を開始する
POST/v1/auth/magic-linkマジックリンクを送信する
POST/v1/auth/email-otp/sendワンタイムコードをメールで送信する
POST/v1/auth/mfa/setupTOTP係数を登録する
POST/v1/auth/refreshトークンペアを更新する
GET/v1/auth/me現在のユーザーを返します
GET/v1/auth/sessionsアクティブなセッションをリストする
DELETE/v1/auth/sessions/{session_id}セッションを取り消す
POST/v1/auth/logout現在のセッションを終了する

さらに進むには#