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

Server Actions в Next.js: авторизация и валидация внутри каждого action

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

Server Action — это публичный POST-эндпоинт

Функция с "use server" выглядит как обычный вызов из компонента, и это обманчиво. Next.js регистрирует для неё идентификатор, и браузер вызывает её POST-запросом на URL страницы с заголовком Next-Action. Любой, кто открыл страницу, видит этот идентификатор в сетевых запросах и может повторить вызов с любыми аргументами через curl.

Отсюда два правила, которые не зависят ни от чего другого:

  1. 1.Каждый action сам проверяет, кто его вызывает и имеет ли право на это действие.
  2. 2.Каждый action сам проверяет входные данные. TypeScript-тип параметра в рантайме ничего не гарантирует.

То, что кнопка удаления видна только администратору, или что страница закрыта middleware, — не защита. В марте 2025 года была исправлена уязвимость CVE-2025-29927: специальный заголовок позволял пропустить middleware целиком. Приложения, у которых авторизация жила только там, оказались открыты.

Слой доступа к сессии

// 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 из React дедуплицирует чтение сессии в рамках одного запроса.

Обёртка для action

// 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-уязвимость, и в Server Actions она встречается особенно часто, потому что ID приходит «из своего же компонента». Любые аргументы — переданные напрямую, через .bind или скрытые поля формы — приходят от клиента и могут быть подменены.

Формы и useActionState

"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>
  );
}

Action для формы получает (prevState, formData). Сделайте тонкий адаптер, который превращает FormData в объект через Object.fromEntries(formData) и передаёт его в ту же схему Zod. required и maxLength в разметке — удобство для пользователя, а не проверка.

Что ещё учесть

  • Возвращаемые данные. Всё, что возвращает action, уходит в браузер. Не возвращайте запись из базы целиком: в ней бывают хеши паролей, email других пользователей, служебные поля.
  • Ошибки. В продакшене Next.js заменяет текст выброшенной ошибки на общий с digest, так что детали не утекают, но и пользователь ничего не поймёт. Ожидаемые ошибки возвращайте как значение { ok: false }, неожиданные — бросайте и логируйте.
  • CSRF. Next.js принимает actions только методом POST и сравнивает заголовок Origin с хостом. Если сайт за прокси с другим доменом, разрешённые источники задаются в experimental.serverActions.allowedOrigins. Отключать эту проверку не нужно.
  • Размер тела. По умолчанию ограничен 1 МБ, меняется через experimental.serverActions.bodySizeLimit. Не поднимайте без нужды: загрузку файлов лучше делать через подписанные URL хранилища.
  • Частота. Action, отправляющий письма или создающий записи, нуждается в лимите так же, как обычный API.

Как проверить свои actions

Откройте DevTools, выполните действие и скопируйте запрос как cURL. Повторите его из терминала: без cookie сессии, с cookie другого пользователя, с чужим threadId, с телом в 10 000 символов сверх лимита. Каждый вариант должен заканчиваться отказом, а не изменением данных.

Когда actions не подходят

Для публичного API, мобильного клиента или вебхуков используйте Route Handlers: у них стабильный URL, явный метод и понятный контракт. Server Actions удобны для мутаций из своего же интерфейса, но правила проверки для них не мягче, а строже — их легче забыть.

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

Ещё на vbcd4u.com