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

Next.js를 위한 기성 로그인 페이지

8개의 작은 파일은 Aurabase 이메일의 링크가 가리키는 페이지를 포함하여 Next.js 앱에 완전한 로그인 흐름을 제공합니다.

튜토리얼8분 읽기레벨 중급2026. 10. 25.에 개정됨

이 페이지는 자동으로 번역되었습니다. 영어 버전은 권위가 있습니다.

1. 고객 및 대리인#

이 페이지는 쿠키 세션과 함께 앱 라우터를 사용합니다( Next.js SSR참조). NEXT_PUBLIC_AURABASE_URL 및 NEXT_PUBLIC_AURABASE_ANON_KEY를 설정한 다음 서버 클라이언트와 프록시를 추가합니다. Next.js 15에서 파일 이름은 middleware.ts, 함수 이름은 middleware입니다.

정보

Next.js 16의 create-next-app은 Cache Components를 활성화합니다. 페이지는 <Suspense> 아래에서 렌더링되는 컴포넌트 안에서만 cookies()나 searchParams를 읽을 수 있으며, 그렇지 않으면 next build가 « uncached or runtime data during prerendering »로 중단됩니다. 아래 페이지는 그렇게 작성되었습니다. 페이지 자체는 정적이고, 요청에 의존하는 부분이 스트리밍으로 도착합니다.

lib/aurabase/server.tstypescript
import { cookies } from 'next/headers'
import { createServerClient } from '@aurabase/aurabase-js/ssr'

export async function serverClient() {
  const store = await cookies()
  return createServerClient(process.env.NEXT_PUBLIC_AURABASE_URL!, process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!, {
    cookies: {
      getAll: () => store.getAll(),
      // Server Components cannot write cookies: the proxy below refreshes the session instead.
      setAll(list) {
        try {
          list.forEach(({ name, value, options }) => store.set(name, value, options))
        } catch {}
      },
    },
  })
}
proxy.tstypescript
import { NextResponse, type NextRequest } from 'next/server'
import { createServerClient } from '@aurabase/aurabase-js/ssr'

const PROTECTED = ['/dashboard']

export async function proxy(request: NextRequest) {
  const response = NextResponse.next({ request })
  const aura = createServerClient(process.env.NEXT_PUBLIC_AURABASE_URL!, process.env.NEXT_PUBLIC_AURABASE_ANON_KEY!, {
    cookies: {
      getAll: () => request.cookies.getAll(),
      setAll(list) {
        list.forEach(({ name, value, options }) => {
          request.cookies.set(name, value)
          response.cookies.set(name, value, options)
        })
      },
    },
  })
  // getUser() refreshes the tokens AND asks the server who the user is. Never authorize with getSession().
  const { data: user } = await aura.auth.getUser()
  if (!user && PROTECTED.some((p) => request.nextUrl.pathname.startsWith(p))) {
    return NextResponse.redirect(new URL('/login', request.url))
  }
  return response
}

export const config = { matcher: ['/((?!_next/static|_next/image|favicon.ico).*)'] }

2. 로그인 및 회원가입#

app/login/actions.tstypescript
'use server'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'

export async function login(formData: FormData) {
  const aura = await serverClient()
  const { data, error } = await aura.auth.signInWithPassword({
    email: String(formData.get('email')),
    password: String(formData.get('password')),
  })
  if (error) redirect(`/login?error=${encodeURIComponent(error.code ?? 'ERROR')}`)
  // A user with MFA enabled gets a challenge instead of a session: ask for the code here.
  if (data && 'mfa_required' in data) redirect(`/login?error=MFA_REQUIRED`)
  redirect('/dashboard')
}

export async function sendMagicLink(formData: FormData) {
  const aura = await serverClient()
  await aura.auth.signInWithMagicLink({ email: String(formData.get('email')) })
  redirect('/login?sent=1')
}
app/login/page.tsxtsx
import { Suspense } from 'react'
import Link from 'next/link'
import { login, sendMagicLink } from './actions'

type Search = Promise<{ error?: string; sent?: string }>

// Reads the query string: must render under <Suspense> (Next.js 16 Cache Components).
async function Notices({ searchParams }: { searchParams: Search }) {
  const { error, sent } = await searchParams
  return (
    <>
      {error && <p role="alert">Sign-in failed: {error}</p>}
      {sent && <p>If this address has an account, a sign-in link was sent.</p>}
    </>
  )
}

export default function LoginPage({ searchParams }: { searchParams: Search }) {
  return (
    <main>
      <h1>Sign in</h1>
      <Suspense fallback={null}>
        <Notices searchParams={searchParams} />
      </Suspense>
      <form action={login}>
        <input name="email" type="email" placeholder="Email" required />
        <input name="password" type="password" placeholder="Password" required />
        <button type="submit">Sign in</button>
      </form>
      <form action={sendMagicLink}>
        <input name="email" type="email" placeholder="Email" required />
        <button type="submit">Email me a sign-in link</button>
      </form>
      <p>
        <Link href="/signup">Create an account</Link> · <Link href="/forgot-password">Forgot your password?</Link>
      </p>
    </main>
  )
}
app/signup/actions.tstypescript
'use server'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'

export async function signup(formData: FormData) {
  const aura = await serverClient()
  const { data, error } = await aura.auth.signUp({
    email: String(formData.get('email')),
    password: String(formData.get('password')),
  })
  if (error) redirect(`/signup?error=${encodeURIComponent(error.message)}`)
  // When the project requires email confirmation there is no session yet: `data.session` is null.
  redirect(data?.session ? '/dashboard' : '/signup?check=1')
}
app/signup/page.tsxtsx
import { Suspense } from 'react'
import Link from 'next/link'
import { signup } from './actions'

type Search = Promise<{ error?: string; check?: string }>

async function Notices({ searchParams }: { searchParams: Search }) {
  const { error, check } = await searchParams
  return (
    <>
      {error && <p role="alert">{error}</p>}
      {check && <p>Check your inbox: confirm your email address to finish.</p>}
    </>
  )
}

export default function SignupPage({ searchParams }: { searchParams: Search }) {
  return (
    <main>
      <h1>Create an account</h1>
      <Suspense fallback={null}>
        <Notices searchParams={searchParams} />
      </Suspense>
      <form action={signup}>
        <input name="email" type="email" placeholder="Email" required />
        <input name="password" type="password" placeholder="Password" required minLength={8} />
        <button type="submit">Sign up</button>
      </form>
      <p>
        <Link href="/login">Already have an account?</Link>
      </p>
    </main>
  )
}

3. 비밀번호 재설정#

재설정 이메일은 <Site URL>/reset-password?token=…에 연결됩니다. Studio › 인증 › 구성에서 사이트 URL을 설정합니다.

app/forgot-password/actions.tstypescript
'use server'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'

export async function requestReset(formData: FormData) {
  const aura = await serverClient()
  await aura.auth.resetPasswordForEmail(String(formData.get('email')))
  // Same answer whether or not the address has an account (no account enumeration).
  redirect('/forgot-password?sent=1')
}
app/forgot-password/page.tsxtsx
import { Suspense } from 'react'
import { requestReset } from './actions'

type Search = Promise<{ sent?: string }>

async function Notice({ searchParams }: { searchParams: Search }) {
  const { sent } = await searchParams
  return sent ? <p>If this address has an account, a reset link was sent.</p> : null
}

export default function ForgotPasswordPage({ searchParams }: { searchParams: Search }) {
  return (
    <main>
      <h1>Reset your password</h1>
      <Suspense fallback={null}>
        <Notice searchParams={searchParams} />
      </Suspense>
      <form action={requestReset}>
        <input name="email" type="email" placeholder="Email" required />
        <button type="submit">Send the link</button>
      </form>
    </main>
  )
}
app/reset-password/actions.tstypescript
'use server'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'

export async function resetPassword(formData: FormData) {
  const token = String(formData.get('token'))
  const aura = await serverClient()
  const { error } = await aura.auth.resetPassword(token, String(formData.get('password')))
  if (error) redirect(`/reset-password?token=${encodeURIComponent(token)}&error=${encodeURIComponent(error.message)}`)
  // The reset signs the user in with a new session; older sessions were revoked.
  redirect('/dashboard')
}
app/reset-password/page.tsxtsx
import { Suspense } from 'react'
import { resetPassword } from './actions'

type Search = Promise<{ token?: string; error?: string }>

async function ResetForm({ searchParams }: { searchParams: Search }) {
  const { token, error } = await searchParams
  if (!token) return <p role="alert">This link is incomplete. Request a new one.</p>
  return (
    <>
      <h1>Choose a new password</h1>
      {error && <p role="alert">{error}</p>}
      <form action={resetPassword}>
        <input type="hidden" name="token" value={token} />
        <input name="password" type="password" placeholder="New password" required minLength={8} />
        <button type="submit">Save</button>
      </form>
    </>
  )
}

export default function ResetPasswordPage({ searchParams }: { searchParams: Search }) {
  return (
    <main>
      <Suspense fallback={null}>
        <ResetForm searchParams={searchParams} />
      </Suspense>
    </main>
  )
}

확인 및 매직 링크 이메일은 <Site URL>/verify-email?token=… 및 <Site URL>/magic-link/verify?token=…에 연결됩니다. 경로 핸들러는 토큰을 사용한 다음 리디렉션합니다.

app/verify-email/route.tstypescript
import { NextResponse, type NextRequest } from 'next/server'
import { serverClient } from '@/lib/aurabase/server'

export async function GET(request: NextRequest) {
  const token = request.nextUrl.searchParams.get('token')
  if (token) {
    const aura = await serverClient()
    const { error } = await aura.auth.verifyOtp({ type: 'signup', token })
    if (!error) return NextResponse.redirect(new URL('/dashboard', request.url))
  }
  return NextResponse.redirect(new URL('/login?error=LINK_INVALID', request.url))
}
app/magic-link/verify/route.tstypescript
import { NextResponse, type NextRequest } from 'next/server'
import { serverClient } from '@/lib/aurabase/server'

export async function GET(request: NextRequest) {
  const token = request.nextUrl.searchParams.get('token')
  if (token) {
    const aura = await serverClient()
    const { error } = await aura.auth.verifyMagicLink(token)
    if (!error) return NextResponse.redirect(new URL('/dashboard', request.url))
  }
  return NextResponse.redirect(new URL('/login?error=LINK_INVALID', request.url))
}

5. 보호된 페이지#

app/dashboard/actions.tstypescript
'use server'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'

export async function logout() {
  const aura = await serverClient()
  await aura.auth.signOut()
  redirect('/login')
}
app/dashboard/page.tsxtsx
import { Suspense } from 'react'
import { redirect } from 'next/navigation'
import { serverClient } from '@/lib/aurabase/server'
import { logout } from './actions'

// Reads the session cookie: must render under <Suspense> (Next.js 16 Cache Components).
async function Account() {
  const aura = await serverClient()
  const { data: user } = await aura.auth.getUser()
  if (!user) redirect('/login')
  return (
    <>
      <p>Signed in as {user.email}</p>
      <form action={logout}>
        <button type="submit">Sign out</button>
      </form>
    </>
  )
}

export default function DashboardPage() {
  return (
    <main>
      <h1>Dashboard</h1>
      <Suspense fallback={<p>Loading…</p>}>
        <Account />
      </Suspense>
    </main>
  )
}

6. 로컬에서 사용해 보세요#

로컬 스택에서는 이메일이 발송되지 않고 Mailpit에 수집되며, 콘솔의 “이메일을 확인하세요” 화면에 인증 링크가 직접 표시됩니다(개발 모드). 직접 만든 앱의 이메일은 kubectl -n aurabase-dev port-forward svc/aurabase-mailpit 8025:8025로 Mailpit 받은편지함을 연 다음 http://localhost:8025에서 확인하세요. 앱의 오리진(예: http://localhost:3000/*)을 Studio › Authentication › Configuration › Redirect URLs에 추가하고 Site URL을 그 값으로 설정하세요.

정보

proxy.ts는 PROTECTED에 나열된 경로에서만 리디렉션됩니다. 프록시는 그 자체로 인증 경계가 아니기 때문에 대시보드 페이지는 getUser()를 사용하여 사용자를 다시 확인합니다.