server-auth-actions — правило Claude Code: что делает, установка
Правило server-auth-actions требует проверять аутентификацию и права внутри каждой Server Action. Оно защищает серверные мутации, которые можно вызвать напрямую.
MIT ★ 4 719 обновлён 2026-10-24
.claude/rules/server-auth-actions.mdЧто делает server-auth-actions
Правило рассматривает функции с "use server" как публичные точки входа, сопоставимые с API-маршрутами. Для каждой Server Action оно задаёт порядок: проверить входные данные, затем сессию, права пользователя и только после этого менять данные. В примерах используются verifySession, unauthorized и схемы zod.
Проверки на уровне middleware, layout или страницы не заменяют защиту внутри самой функции: Server Action можно вызвать напрямую. Это значит, что удаление пользователя должно разрешаться администратору или самому пользователю, а обновление профиля — только его владельцу. Для Claude Code правило устанавливается файлом .claude/rules/server-auth-actions.md; платформа также указана среди поддерживаемых для Codex.
Какие задачи решает
- проверить доступ к Server Action
- закрыть удаление чужих пользователей
- разрешить изменение только собственного профиля
- валидировать данные перед мутацией
Примеры запросов агенту
- Проверь все Server Actions в проекте и добавь проверку сессии внутри каждой функции.
- Перепиши удаление пользователя так, чтобы его выполнял администратор или сам пользователь.
- Добавь проверку
zodперед обновлением профиля и запрети менять чужой профиль.
Как установить server-auth-actions
Вручную: положить файлы
.claude/rules/server-auth-actions.mdПоле paths во frontmatter ограничивает файлы
AGENTS.md
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/server-auth-actions.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/server-auth-actions.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/server-auth-actions.mdВручную: положить файлы
.clinerules/server-auth-actions.mdПо шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать
Вопросы о server-auth-actions
Как установить server-auth-actions в Claude Code?
Добавьте файл правила по пути .claude/rules/server-auth-actions.md.
Что делает server-auth-actions?
Правило требует защищать каждую Server Action внутри самой функции: валидировать входные данные, проверять аутентификацию и права перед изменением данных.
Почему проверки middleware недостаточно для Server Actions?
Server Action можно вызвать напрямую, поэтому проверки middleware, layout или страницы не заменяют аутентификацию и авторизацию внутри функции.
Исходный текст
server-auth-actions.md · MIT
---
title: Authenticate Server Actions Like API Routes
impact: CRITICAL
impactDescription: prevents unauthorized access to server mutations
tags: server, server-actions, authentication, security, authorization
---
## Authenticate Server Actions Like API Routes
**Impact: CRITICAL (prevents unauthorized access to server mutations)**
Server Actions (functions with `"use server"`) are exposed as public endpoints, just like API routes. Always verify authentication and authorization **inside** each Server Action—do not rely solely on middleware, layout guards, or page-level checks, as Server Actions can be invoked directly.
Next.js documentation explicitly states: "Treat Server Actions with the same security considerations as public-facing API endpoints, and verify if the user is allowed to perform a mutation."
**Incorrect (no authentication check):**
```typescript
"use server"
export async function deleteUser(userId: string) {
// Anyone can call this! No auth check
await db.user.delete({ where: { id: userId } })
return { success: true }
}
```
**Correct (authentication inside the action):**
```typescript
"use server"
import { verifySession } from "@/lib/auth"
import { unauthorized } from "@/lib/errors"
export async function deleteUser(userId: string) {
// Always check auth inside the action
const session = await verifySession()
if (!session) {
throw unauthorized("Must be logged in")
}
// Check authorization too
if (session.user.role !== "admin" && session.user.id !== userId) {
throw unauthorized("Cannot delete other users")
}
await db.user.delete({ where: { id: userId } })
return { success: true }
}
```
**With input validation:**
```typescript
"use server"
import { verifySession } from "@/lib/auth"
import { z } from "zod"
const updateProfileSchema = z.object({
userId: z.string().uuid(),
name: z.string().min(1).max(100),
email: z.string().email(),
})
export async function updateProfile(data: unknown) {
// Validate input first
const validated = updateProfileSchema.parse(data)
// Then authenticate
const session = await verifySession()
if (!session) {
throw new Error("Unauthorized")
}
// Then authorize
if (session.user.id !== validated.userId) {
throw new Error("Can only update own profile")
}
// Finally perform the mutation
await db.user.update({
where: { id: validated.userId },
data: {
name: validated.name,
email: validated.email,
},
})
return { success: true }
}
```
Reference: [https://nextjs.org/docs/app/guides/authentication](https://nextjs.org/docs/app/guides/authentication)
© zebbern · MIT · zebbern/claude-code-guide