xonecas.io
556
Bn

bees-nest / files

bees-nest / .opencode / skills / vercel-react-best-practices / rules / server-auth-actions.md

2.6 KB
1---
2title: Authenticate Server Actions Like API Routes
3impact: CRITICAL
4impactDescription: prevents unauthorized access to server mutations
5tags: server, server-actions, authentication, security, authorization
6---
7
8## Authenticate Server Actions Like API Routes
9
10**Impact: CRITICAL (prevents unauthorized access to server mutations)**
11
12Server 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.
13
14Next.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."
15
16**Incorrect (no authentication check):**
17
18```typescript
19'use server'
20
21export async function deleteUser(userId: string) {
22  // Anyone can call this! No auth check
23  await db.user.delete({ where: { id: userId } })
24  return { success: true }
25}
26```
27
28**Correct (authentication inside the action):**
29
30```typescript
31'use server'
32
33import { verifySession } from '@/lib/auth'
34import { unauthorized } from '@/lib/errors'
35
36export async function deleteUser(userId: string) {
37  // Always check auth inside the action
38  const session = await verifySession()
39  
40  if (!session) {
41    throw unauthorized('Must be logged in')
42  }
43  
44  // Check authorization too
45  if (session.user.role !== 'admin' && session.user.id !== userId) {
46    throw unauthorized('Cannot delete other users')
47  }
48  
49  await db.user.delete({ where: { id: userId } })
50  return { success: true }
51}
52```
53
54**With input validation:**
55
56```typescript
57'use server'
58
59import { verifySession } from '@/lib/auth'
60import { z } from 'zod'
61
62const updateProfileSchema = z.object({
63  userId: z.string().uuid(),
64  name: z.string().min(1).max(100),
65  email: z.string().email()
66})
67
68export async function updateProfile(data: unknown) {
69  // Validate input first
70  const validated = updateProfileSchema.parse(data)
71  
72  // Then authenticate
73  const session = await verifySession()
74  if (!session) {
75    throw new Error('Unauthorized')
76  }
77  
78  // Then authorize
79  if (session.user.id !== validated.userId) {
80    throw new Error('Can only update own profile')
81  }
82  
83  // Finally perform the mutation
84  await db.user.update({
85    where: { id: validated.userId },
86    data: {
87      name: validated.name,
88      email: validated.email
89    }
90  })
91  
92  return { success: true }
93}
94```
95
96Reference: [https://nextjs.org/docs/app/guides/authentication](https://nextjs.org/docs/app/guides/authentication)