Как обезопасить Server Actions
На этой странице
Server Action — это публичный HTTP-эндпоинт: Next.js присваивает каждой экспортированной функции с "use server" идентификатор, и любой, кто его узнал (он есть в клиентском бандле), может отправить POST с произвольными аргументами. Поэтому внутри каждой Action обязательны: аутентификация (кто вызывает), авторизация (есть ли права на эту запись — защита от IDOR), валидация входа (Zod: типы, длины, форматы — аргументы приходят с клиента), ограничение частоты (rate limit) для дорогих операций, минимальный ответ без лишних данных. Next.js помогает: проверяет Origin против Host (защита от CSRF), шифрует значения, захваченные замыканием, удаляет неиспользуемые Actions из сборки, ограничивает размер тела (serverActions.bodySizeLimit). Но «скрыть кнопку» или проверить роль только в UI — не защита. Удобно выносить проверки в слой доступа к данным (DAL) с import 'server-only'.
Вопрос
Почему Server Actions нужно защищать так же, как API? Какие проверки обязательны и что Next.js делает сам?
Как атакуют
1. Открыть DevTools → найти POST-запрос Action с заголовком Next-Action: 7f3a…
2. Повторить запрос с другими аргументами:
deleteComment("чужой-комментарий-id") ← нет проверки владельца (IDOR)
updateRole({ userId: "me", role: "admin" }) ← нет проверки прав и схемы
sendInvite(...) × 10 000 ← нет rate limitНебезопасно
'use server';
export async function deleteComment(commentId: string) {
await db.comment.delete({ where: { id: commentId } }); // ✗ кто угодно удалит что угодно
revalidatePath('/posts');
}Безопасно
// lib/dal.ts — слой доступа к данным
import 'server-only';
import { cache } from 'react';
import { cookies } from 'next/headers';
export const getCurrentUser = cache(async () => {
const token = (await cookies()).get('session')?.value;
if (!token) return null;
return verifySession(token); // проверка подписи/сессии в БД
});
export async function requireUser() {
const user = await getCurrentUser();
if (!user) throw new Error('UNAUTHENTICATED');
return user;
}// app/posts/actions.ts
'use server';
import { z } from 'zod';
import { updateTag } from 'next/cache';
import { requireUser } from '@/lib/dal';
import { rateLimit } from '@/lib/rate-limit';
const DeleteSchema = z.object({ commentId: z.string().uuid() });
export async function deleteComment(input: unknown) {
// 1. Аутентификация
const user = await requireUser();
// 2. Валидация: аргументы пришли с клиента и могут быть любыми
const parsed = DeleteSchema.safeParse(input);
if (!parsed.success) return { ok: false, error: 'Некорректные данные' };
// 3. Rate limit
if (!(await rateLimit(`delete-comment:${user.id}`, { max: 20, windowSec: 60 }))) {
return { ok: false, error: 'Слишком много запросов' };
}
// 4. Авторизация на конкретную запись
const comment = await db.comment.findUnique({ where: { id: parsed.data.commentId } });
if (!comment) return { ok: false, error: 'Не найдено' };
if (comment.authorId !== user.id && !user.roles.includes('moderator')) {
return { ok: false, error: 'Нет прав' }; // не раскрываем лишних деталей
}
await db.comment.delete({ where: { id: comment.id } });
updateTag(`post-${comment.postId}`);
return { ok: true };
}Что Next.js делает сам
| Защита | Как работает | Ограничения |
|---|---|---|
| CSRF | Actions принимают только POST; Origin сравнивается с Host | За прокси/на нескольких доменах настрой serverActions.allowedOrigins |
| Шифрование замыканий | Значения, захваченные inline-Action из серверного компонента, шифруются перед отправкой клиенту | Не храни секреты в замыканиях всё равно; ключ — NEXT_SERVER_ACTIONS_ENCRYPTION_KEY для нескольких инстансов |
| Удаление неиспользуемых | Action, которую нигде не используют, не получает публичного ID | Используемая — публична |
| Непредсказуемые ID | ID пересоздаются между сборками | Это не авторизация |
| Лимит тела | По умолчанию 1 МБ (serverActions.bodySizeLimit) | Для файлов — отдельная настройка или прямая загрузка в хранилище |
Замыкания и утечки
// Серверный компонент
export default async function Page() {
const user = await requireUser();
async function rename(formData: FormData) {
'use server';
// user.id из замыкания зашифрован, но проверять права всё равно нужно здесь же
await requireUser(); // актуальная сессия на момент вызова
// ...
}
return <form action={rename}>…</form>;
}- Не передавай в клиент объекты целиком:
<Profile user={user} />отправит все поля, включаяpasswordHash, если они были в объекте. Используй DTO с нужными полями. experimental.taint(taintObjectReference,taintUniqueValueиз React) запрещает передачу помеченных объектов и значений в клиент — страховка от случайных утечек.
Ответы и ошибки
- Возвращай понятные пользователю ошибки как данные (
{ ok: false, error }), а не стек. - Ошибки, выброшенные в Action, в production приходят на клиент без деталей — с
digestдля поиска в логах. - Логируй попытки доступа без прав — это сигнал атаки.
Чек-лист для каждой Action
- Проверена сессия (не доверять
userIdиз аргументов). - Проверены права на конкретный ресурс.
- Вход провалидирован схемой.
- Есть rate limit для дорогих и чувствительных операций.
- Ответ не содержит лишних данных.
- После мутации обновлён кэш (
updateTag,revalidatePath,refresh).
Мини-шпаргалка
Action = публичный POST-эндпоинт
Auth (сессия) → Validate (Zod) → Rate limit → Authorize (владелец/роль) → Mutate → updateTag
Next.js: Origin-check (CSRF), шифрование замыканий, bodySizeLimit, удаление неиспользуемых
DAL + server-only, DTO, taint