Next.js में सर्वर क्रियाएँ: प्रत्येक क्रिया के अंदर प्राधिकरण और सत्यापन
सर्वर एक्शन एक सार्वजनिक POST समापन बिंदु है
"use server" वाला फ़ंक्शन किसी घटक से सामान्य कॉल जैसा दिखता है, और यह भ्रामक है। Next.js इसके लिए एक आईडी पंजीकृत करता है, और ब्राउज़र इसे Next-Action शीर्षक वाले पृष्ठ URL पर POST अनुरोध के साथ कॉल करता है। पेज खोलने वाला कोई भी व्यक्ति नेटवर्क अनुरोधों में इस आईडी को देखता है और curl के माध्यम से किसी भी तर्क के साथ कॉल का पुनः प्रयास कर सकता है।
इसलिए दो नियम जो किसी और चीज़ पर निर्भर नहीं हैं:
- 1.प्रत्येक क्रिया स्वयं जाँच करती है कि उसे कौन बुला रहा है और क्या उसे यह क्रिया करने का अधिकार है।
- 2.प्रत्येक क्रिया स्वयं इनपुट डेटा की जाँच करती है। पैरामीटर का टाइपस्क्रिप्ट प्रकार रनटाइम पर किसी भी चीज़ की गारंटी नहीं देता है।
यह तथ्य कि डिलीट बटन केवल व्यवस्थापक को दिखाई देता है, या पेज मिडलवेयर द्वारा बंद है, सुरक्षा नहीं है। मार्च 2025 में, CVE-2025-29927 भेद्यता को ठीक किया गया: एक विशेष हेडर ने मिडलवेयर को पूरी तरह से छोड़ने की अनुमति दी। वे एप्लिकेशन जिनका प्राधिकरण केवल वहीं रहता था, खुले थे।
सत्र पहुंच परत
// lib/auth/session.ts
import "server-only";
import { cookies } from "next/headers";
import { cache } from "react";
import { db } from "@/lib/db";
export const getSession = cache(async () => {
const jar = await cookies(); // в Next.js 15 cookies() асинхронна
const token = jar.get("__Host-session")?.value;
if (!token) return null;
return db.session.findValid(token); // { userId, role } или null
});
export async function requireUser() {
const s = await getSession();
if (!s) throw new Error("unauthenticated");
return s;
}server-only को आयात करने से इस मॉड्यूल का क्लाइंट घटक में गलती से आयात एक बिल्ड त्रुटि में बदल जाएगा। cache रिएक्ट से एक ही अनुरोध के भीतर सत्र रीडिंग को कम कर देता है।
कार्रवाई के लिए रैपर
// lib/actions/safe-action.ts
import "server-only";
import { z } from "zod";
import { requireUser } from "@/lib/auth/session";
export type ActionResult<T> = { ok: true; data: T } | { ok: false; error: string };
export function authedAction<S extends z.ZodTypeAny, T>(
schema: S,
handler: (input: z.infer<S>, user: { userId: string; role: string }) => Promise<T>
) {
return async (raw: unknown): Promise<ActionResult<T>> => {
const user = await requireUser().catch(() => null);
if (!user) return { ok: false, error: "Нужно войти" };
const parsed = schema.safeParse(raw);
if (!parsed.success) return { ok: false, error: "Некорректные данные" };
return { ok: true, data: await handler(parsed.data, user) };
};
}एप्लिकेशन: स्वामित्व की जाँच करना, न कि केवल लॉगिन करना
// app/threads/[id]/actions.ts
"use server";
import { z } from "zod";
import { revalidatePath } from "next/cache";
import { authedAction } from "@/lib/actions/safe-action";
import { db } from "@/lib/db";
const EditInput = z.object({
threadId: z.string().uuid(),
body: z.string().trim().min(1).max(20_000),
});
export const editThread = authedAction(EditInput, async ({ threadId, body }, user) => {
const updated = await db.query(
`UPDATE threads SET body = $1, updated_at = now()
WHERE id = $2 AND (author_id = $3 OR $4 = 'moderator')
RETURNING id`,
[body, threadId, user.userId, user.role]
);
if (updated.rowCount === 0) throw new Error("not found or forbidden");
revalidatePath(`/threads/${threadId}`);
return { id: threadId };
});स्वामित्व जांच WHERE में अंतर्निहित है: आप threadId को प्रतिस्थापित करके किसी और की शाखा को संपादित नहीं कर सकते। यह एक क्लासिक IDOR भेद्यता है, और यह सर्वर क्रियाओं में विशेष रूप से आम है क्योंकि आईडी "अपने स्वयं के घटक से आती है।" कोई भी तर्क - सीधे, .bind या छिपे हुए फॉर्म फ़ील्ड के माध्यम से पारित किया जाता है - क्लाइंट से आता है और बदला जा सकता है।
फॉर्म और एक्शनस्टेट का उपयोग करें
"use client";
import { useActionState } from "react";
import { editThreadForm } from "./actions";
export function EditForm({ threadId }: { threadId: string }) {
const [state, action, pending] = useActionState(editThreadForm, null);
return (
<form action={action}>
<input type="hidden" name="threadId" value={threadId} />
<textarea name="body" required maxLength={20000} />
<button disabled={pending}>Сохранить</button>
{state && !state.ok && <p role="alert">{state.error}</p>}
</form>
);
}प्रपत्र के लिए कार्रवाई (prevState, formData) हो जाती है। एक पतला एडाप्टर बनाएं जो FormData को Object.fromEntries(formData) के माध्यम से एक ऑब्जेक्ट में बदल देता है और इसे उसी ज़ॉड स्कीमा में भेज देता है। मार्कअप में required और maxLength उपयोगकर्ता की सुविधा है, सत्यापन नहीं।
और क्या विचार करें
- डेटा लौटाया गया। क्रिया द्वारा लौटाई गई हर चीज़ ब्राउज़र में जाती है। डेटाबेस से संपूर्ण रिकॉर्ड वापस न करें: इसमें पासवर्ड के हैश, अन्य उपयोगकर्ताओं के ईमेल और सेवा फ़ील्ड शामिल हैं।
- त्रुटियाँ। उत्पादन में, नेक्स्ट.जेएस फेंकी गई त्रुटि के टेक्स्ट को
digestसे बदल देता है, ताकि विवरण लीक न हो, लेकिन उपयोगकर्ता को कुछ भी समझ में नहीं आएगा। अपेक्षित त्रुटियों को मान के रूप में लौटाएँ{ ok: false }, अप्रत्याशित त्रुटियाँ - फेंकें और लॉग करें। - CSRF. Next.js केवल POST पद्धति का उपयोग करके कार्रवाई स्वीकार करता है और
Originहेडर की तुलना होस्ट से करता है। यदि साइट किसी भिन्न डोमेन वाले प्रॉक्सी के पीछे है, तो अनुमत स्रोतexperimental.serverActions.allowedOriginsमें सेट किए गए हैं। इस चेक को अक्षम करने की कोई आवश्यकता नहीं है. - शरीर का आकार। डिफ़ॉल्ट रूप से 1 एमबी तक सीमित,
experimental.serverActions.bodySizeLimitके माध्यम से परिवर्तन। इसे अनावश्यक रूप से न बढ़ाएं: हस्ताक्षरित स्टोरेज यूआरएल के माध्यम से फ़ाइलें अपलोड करना बेहतर है। - फ़्रीक्वेंसी। एक क्रिया जो ईमेल भेजती है या पोस्ट बनाती है, उसे नियमित एपीआई की तरह ही एक सीमा की आवश्यकता होती है।
अपने कार्यों की जांच कैसे करें
DevTools खोलें, कार्रवाई करें और अनुरोध को cURL के रूप में कॉपी करें। टर्मिनल से इसे दोहराएँ: सत्र कुकी के बिना, किसी अन्य उपयोगकर्ता की कुकी के साथ, किसी और की threadId के साथ, सीमा से अधिक 10,000 वर्णों के साथ। प्रत्येक विकल्प का परिणाम विफलता होना चाहिए, न कि डेटा में परिवर्तन।
जब कार्य उचित न हों
सार्वजनिक एपीआई, मोबाइल क्लाइंट या वेबहुक के लिए, रूट हैंडलर का उपयोग करें: उनके पास एक स्थिर यूआरएल, एक स्पष्ट विधि और एक स्पष्ट अनुबंध है। सर्वर क्रियाएँ अपने स्वयं के इंटरफ़ेस से उत्परिवर्तन के लिए सुविधाजनक हैं, लेकिन उनके लिए सत्यापन नियम नरम नहीं हैं, बल्कि सख्त हैं - उन्हें भूलना आसान है।