본문으로 건너뛰기
아우라베이스 로고
아우라베이스

인증

단일 SDK에서 제공되는 15개 공급자, TOTP MFA, 매직 링크, 이메일 및 SMS를 통한 일회성 코드, 역할 기반 액세스 제어가 포함된 OAuth.

설명7분 읽기레벨 중급2026. 4. 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에 있습니다.

세 명의 배우, 세 가지 책임#

클라이언트는 챌린지에 서명하고, 서비스는 데이터베이스를 쿼리하고, 게이트웨이는 각 후속 요청에 대해 유효성을 검사합니다.

로그인 흐름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 TOTP. Authy, 1Password, Google OTP. 대체 SMS.
  • 매직 링크 및 OTP. 비밀번호가 없는 이메일, i18n 템플릿, 주소별 속도 제한.
  • 세분화된 RBAC. 역할, 권한, 조직 계층. 자체 생성된 RLS 정책.
  • 세션 바인딩. 장치 지문, IP 확인, 회전 새로 고침 토큰.

스트림 4개, SDK 1개#

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 앱 라우터에서는 항상 서버 작업 및 경로 처리기에서 @aurabase/aurabase-js/ssr의 createServerClient 도우미를 사용하세요. 쿠키 새로 고침 토큰은 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현재 세션 종료

더 나아가려면#