v(i)b(e)c(o)d(e)4u.com
Назад на форум vbcd4u.com
🔥 Нейросети2026-11-17T10:03:00.000Z▲ 0 upvotes

Next.js ішіндегі сервер әрекеттері: әрбір әрекеттің ішінде авторизация және тексеру

@murdasoftРедакция vbcd4u · MurdaSoft
Открыть все обсуждения →

Сервер әрекеті жалпыға ортақ POST соңғы нүктесі болып табылады

"use server" функциясы құрамдастың қалыпты шақыруы сияқты көрінеді және бұл алдамшы. Next.js ол үшін идентификаторды тіркейді және браузер оны POST сұрауы арқылы Next-Action тақырыбы бар URL бетке шақырады. Бетті ашқан кез келген адам бұл идентификаторды желі сұрауларында көреді және curl арқылы кез келген аргументтермен қоңырауды қайталай алады.

Демек, басқа ештеңеге тәуелді емес екі ереже:

  1. 1.Әрбір әрекеттің өзі оны кім шақыратынын және оның осы әрекетті орындауға құқығы бар-жоғын тексереді.
  2. 2.Әрбір әрекеттің өзі енгізілген деректерді тексереді. Параметрдің TypeScript түрі орындалу уақытында ештеңеге кепілдік бермейді.

Жою түймешігінің тек әкімшіге көрінуі немесе беттің аралық бағдарлама арқылы жабылуы қорғаныс болып табылмайды. 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 импорттау бұл модульді клиент құрамдас бөлігіне кездейсоқ импорттауды құрастыру қатесіне айналдырады. React қолданбасынан 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 немесе жасырын пішін өрістері арқылы жіберіледі - клиенттен келеді және оларды ауыстыруға болады.

Пішіндер және ActionState пайдаланыңыз

"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) арқылы нысанға айналдыратын және оны бірдей Zod схемасына беретін жұқа адаптер жасаңыз. Белгілеудегі required және maxLength тексеру емес, пайдаланушының ыңғайлылығы болып табылады.

Тағы нені ескеру керек

  • Қайтарылған деректер. Әрекет қайтаратынның бәрі браузерге өтеді. Дерекқордан барлық жазбаны қайтармаңыз: онда парольдердің хэштері, басқа пайдаланушылардың электрондық пошталары және қызмет өрістері бар.
  • Қателер. Өндірісте Next.js жіберілген қатенің мәтінін digest арқылы жалпыға ауыстырады, осылайша мәліметтер ағып кетпейді, бірақ пайдаланушы ештеңе түсінбейді. Күтілетін қателерді { ok: false } мәні ретінде қайтарыңыз, күтпеген қателер - тастау және журнал.
  • CSRF. Next.js әрекеттерді тек POST әдісі арқылы қабылдайды және Origin тақырыбын хостпен салыстырады. Егер сайт басқа домені бар проксидің артында болса, рұқсат етілген көздер experimental.serverActions.allowedOrigins ішінде орнатылады. Бұл тексеруді өшірудің қажеті жоқ.
  • Дене өлшемі. Әдепкі бойынша 1 МБ шектелген, experimental.serverActions.bodySizeLimit арқылы өзгереді. Оны қажетсіз көтермеңіз: файлдарды қол қойылған сақтау URL мекенжайлары арқылы жүктеп салған дұрыс.
  • Жиілік. Электрондық хаттарды жіберетін немесе жазбалар жасайтын әрекетке әдеттегі API сияқты шектеу қажет.

Әрекеттеріңізді қалай тексеруге болады

DevTools бағдарламасын ашыңыз, әрекетті орындаңыз және сұрауды cURL ретінде көшіріңіз. Оны терминалдан қайталаңыз: сеанс кукисіз, басқа пайдаланушының cookie файлымен, басқа біреудің threadId мәтінімен, шегінен 10 000 таңбадан асатын. Әрбір опция деректердің өзгеруіне емес, сәтсіздікке әкелуі керек.

Әрекеттер орынды болмаған кезде

Қоғамдық API, мобильді клиент немесе веб-хуктар үшін Маршрут өңдеушілерін пайдаланыңыз: олардың тұрақты URL мекенжайы, айқын әдісі және анық келісім-шарттары бар. Сервер әрекеттері өз интерфейсіндегі мутациялар үшін ыңғайлы, бірақ олар үшін тексеру ережелері жұмсақ емес, бірақ қатаңырақ - оларды ұмыту оңайырақ.

Обсуждение (0)

Ещё на vbcd4u.com