인증
단일 SDK에서 제공되는 15개 공급자, TOTP MFA, 매직 링크, 이메일 및 SMS를 통한 일회성 코드, 역할 기반 액세스 제어가 포함된 OAuth.
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에 있습니다.
세 명의 배우, 세 가지 책임#
클라이언트는 챌린지에 서명하고, 서비스는 데이터베이스를 쿼리하고, 게이트웨이는 각 후속 요청에 대해 유효성을 검사합니다.
# 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개#
'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}/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 | 현재 세션 종료 |