Server Actions в Next.js: авторизация и валидация внутри каждого action
Server Action — это публичный POST-эндпоинт
Функция с "use server" выглядит как обычный вызов из компонента, и это обманчиво. Next.js регистрирует для неё идентификатор, и браузер вызывает её POST-запросом на URL страницы с заголовком Next-Action. Любой, кто открыл страницу, видит этот идентификатор в сетевых запросах и может повторить вызов с любыми аргументами через curl.
Отсюда два правила, которые не зависят ни от чего другого:
- 1.Каждый action сам проверяет, кто его вызывает и имеет ли право на это действие.
- 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 удобны для мутаций из своего же интерфейса, но правила проверки для них не мягче, а строже — их легче забыть.