re:re:actable
Урок 055 минут чтения

Как обезопасить 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 делает сам

ЗащитаКак работаетОграничения
CSRFActions принимают только POST; Origin сравнивается с HostЗа прокси/на нескольких доменах настрой serverActions.allowedOrigins
Шифрование замыканийЗначения, захваченные inline-Action из серверного компонента, шифруются перед отправкой клиентуНе храни секреты в замыканиях всё равно; ключ — NEXT_SERVER_ACTIONS_ENCRYPTION_KEY для нескольких инстансов
Удаление неиспользуемыхAction, которую нигде не используют, не получает публичного IDИспользуемая — публична
Непредсказуемые IDID пересоздаются между сборкамиЭто не авторизация
Лимит телаПо умолчанию 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

Документация

Дочитали до конца?
Отметьте урок — прогресс сохранится в браузере.

Поиск

Поиск по урокам