صفحات تسجيل دخول جاهزة لـ Next.js
توفر ثمانية ملفات صغيرة لتطبيق Next.js تدفقًا كاملاً لتسجيل الدخول، بما في ذلك الصفحات التي تشير إليها الروابط الموجودة في رسائل البريد الإلكتروني Aurabase.
1. العملاء والوكيل#
تستخدم هذه الصفحات جهاز توجيه التطبيق مع جلسات ملفات تعريف الارتباط (راجع Next.js SSR). قم بتعيين NEXT_PUBLIC_AURABASE_URL و NEXT_PUBLIC_AURABASE_ANON_KEY، ثم قم بإضافة عميل الخادم والوكيل. في Next.js 15، قم بتسمية الملف middleware.ts والدالة middleware.
يفعّل create-next-app في Next.js 16 ميزة Cache Components: لا يمكن للصفحة قراءة cookies() أو searchParams إلا داخل مكوّن يُعرض تحت <Suspense>، وإلا يتوقف next build برسالة « uncached or runtime data during prerendering ». الصفحات أدناه مكتوبة بهذه الطريقة: الصفحة نفسها ثابتة، والجزء المعتمد على الطلب يصل بالبث.
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 {}
},
},
})
}
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. قم بتسجيل الدخول والاشتراك#
'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')
}
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>
)
}
'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')
}
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=…. قم بتعيين عنوان URL للموقع في الاستوديو ›المصادقة› التكوين.
'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')
}
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>
)
}
'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')
}
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>
)
}
4. البريد الإلكتروني والروابط السحرية#
تصل رسائل البريد الإلكتروني الخاصة بالتأكيد والرابط السحري إلى <Site URL>/verify-email?token=… و<Site URL>/magic-link/verify?token=…. يستهلك معالج المسار الرمز المميز، ثم يعيد التوجيه.
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))
}
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. الصفحة المحمية#
'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')
}
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 رسائل البريد بدلاً من إرسالها، وتعرض شاشة « تحقق من بريدك » في وحدة التحكم رابط التحقق نفسه (وضع التطوير). بالنسبة إلى رسائل تطبيقك، افتح صندوق Mailpit عبر kubectl -n aurabase-dev port-forward svc/aurabase-mailpit 8025:8025 ثم http://localhost:8025. أضف أصل تطبيقك (مثلاً http://localhost:3000/*) في Studio › Authentication › Configuration › Redirect URLs واضبط Site URL عليه.
proxy.ts عمليات إعادة التوجيه فقط على المسارات المدرجة في PROTECTED؛ تتحقق صفحة لوحة المعلومات من المستخدم مرة أخرى باستخدام getUser() لأن الوكيل ليس حد ترخيص في حد ذاته.