Λίστα Ελέγχου Ασφάλειας Next.js 16 (Production Security & Hardening Checklist)
Ο απόλυτος οδηγός θωράκισης για Next.js 16: Zod validation σε Server Actions, CSRF/SSRF mitigation, strict Content Security Policy (CSP) και προστασία δεδομένων σε RSC payloads.
Έλεγχος περιεχομένου: 2026-11-09
17 min ανάγνωση • Robo Lead Instructor
- Προαπαιτούμενα
- 1. Αυστηρή Επικύρωση Εισόδου (Input Validation) με Zod
- 2. Αποτροπή Διαρροής Μυστικών με το πακέτο `server-only`
- 3. Προστασία από Server-Side Request Forgery (SSRF)
- 4. Αυστηρά Security Headers (η CSP ζει στην §7)
- 5. Προστασία Δεδομένων στα React Server Components (RSC Payloads)
- 6. Προστασία CSRF σε Server Actions
- 7. Content Security Policy (CSP) ως Response Header & Φιλτράρισμα RSC Payloads
- 8. Ασφαλή Cookies + Rate Limiting
- Ανακεφαλαίωση
Διαδραστική Λίστα Ελέγχου (Audit Checklist)
Ολοκληρώθηκαν 0 από 6 ελέγχους (0%)
1. Αυστηρή Επικύρωση Εισόδου (Input Validation) με Zod
4. Αυστηρά Security Headers (η CSP ζει στην §7)
8. Ασφαλή Cookies + Rate Limiting
Η μετάβαση στο App Router και τα Server Components άλλαξε ριζικά το μοντέλο ασφαλείας του Next.js. Κώδικας που προηγουμένως εκτελούνταν στο browser πλέον τρέχει στον server, ενώ τα Server Actions λειτουργούν ως δημόσια εκτεθειμένα HTTP POST endpoints!
Ακολουθήστε αυτή τη λίστα 8 κρίσιμων σημείων πριν αναπτύξετε οποιαδήποτε εφαρμογή Next.js 16 σε παραγωγή.
Προαπαιτούμενα
Βασική εξοικείωση με το App Router (βλ. Welcome to Next.js 16) και με Server Actions/cookies (βλ. Supabase SSR session management).
1. Αυστηρή Επικύρωση Εισόδου (Input Validation) με Zod
Κάθε Server Action είναι ένα δημόσιο POST endpoint. Οποιοσδήποτε μπορεί να στείλει αυθαίρετο JSON payload χρησιμοποιώντας το curl:
'use server'
import { z } from 'zod';
import { db } from '@/lib/db';
import { getAuthenticatedUser } from '@/lib/auth';
const updateProfileSchema = z.object({
fullName: z.string().trim().min(2).max(50),
bio: z.string().max(200).optional(),
}).strict();
export async function updateProfileAction(formData: unknown) {
// 1. Έλεγχος ταυτότητας
const user = await getAuthenticatedUser();
if (!user) throw new Error('Unauthorized');
// 2. Αυστηρή επικύρωση τύπων και ορίων
const result = updateProfileSchema.safeParse(formData);
if (!result.success) {
return { error: 'Μη έγκυρα δεδομένα εισόδου.' };
}
// 3. Ασφαλής ενημέρωση
await db.profiles.update({
where: { id: user.id },
data: result.data,
});
return { success: true };
}- Επικυρώστε κάθε Server Action με Zod schema πριν την εγγραφή στη βάση
- Απορρίψτε payloads με άγνωστα πεδία χρησιμοποιώντας αυστηρά schemas
2. Αποτροπή Διαρροής Μυστικών με το πακέτο server-only
Συχνά, developers εισάγουν κατά λάθος αρχεία με API keys (π.χ. Stripe secret keys) σε Client Components. Το πακέτο server-only προκαλεί build-time error εάν επιχειρηθεί η εισαγωγή (import) του αρχείου σε Client Component:
npm install server-only// src/lib/billing/stripe-admin.ts
import 'server-only';
import Stripe from 'stripe';
export const stripeAdmin = new Stripe(process.env.STRIPE_SECRET_KEY!, {
// Ίδιο pin με την εφαρμογή (βλ. STRIPE_API_VERSION στο src/lib/billing/stripe.ts).
apiVersion: '2026-10-28.endive',
});3. Προστασία από Server-Side Request Forgery (SSRF)
Εάν η εφαρμογή σας επιτρέπει στους χρήστες να εισάγουν URLs (π.χ. avatar URL, webhooks, RSS feeds), ένας κακόβουλος χρήστης μπορεί να ζητήσει εσωτερικές διευθύνσεις του VPS (http://169.254.169.254 για cloud metadata ή http://localhost:5432):
// Πρώτο φίλτρο μόνο — η denylist από μόνη της ΔΕΝ επαρκεί (βλ. παρακάτω).
export function isSafeExternalUrl(inputUrl: string): boolean {
let parsed: URL;
try {
parsed = new URL(inputUrl);
} catch {
return false;
}
if (!['http:', 'https:'].includes(parsed.protocol)) return false;
// Ευρύ μπλοκάρισμα: localhost, IPv4 ιδιωτικά (10/8, 172.16/12, 192.168/16),
// link-local/metadata (169.254/16), unspecified (0.0.0.0) και IPv6 loopback.
const hostname = parsed.hostname.toLowerCase();
if (
hostname === 'localhost' ||
hostname === '127.0.0.1' ||
hostname === '0.0.0.0' ||
hostname === '::1' ||
hostname === '[::1]' ||
hostname.startsWith('10.') ||
hostname.startsWith('192.168.') ||
/^172\.(1[6-9]|2\d|3[01])\./.test(hostname) ||
hostname.startsWith('169.254.') ||
hostname.startsWith('::ffff:')
) {
return false;
}
return true;
}[!CAUTION] Η παραπάνω denylist είναι πρώτο φίλτρο, όχι επαρκής άμυνα: δεν πιάνει δεκαδικές/δεκαεξαδικές/octal κωδικοποιήσεις IP, DNS rebinding (το hostname επιλύεται σε εσωτερική IP μετά τον έλεγχο) ούτε redirects (ελέγχετε το αρχικό URL, το fetch ακολουθεί αλλού). Σε παραγωγή προτιμήστε: (α) allowlist γνωστών hosts όπου γίνεται· (β) DNS resolution check στον server (επιλύστε το hostname και ξανα-ελέγξτε κάθε IP πριν το fetch)· (γ)
fetch(url, { redirect: 'manual' })+ έλεγχο τουLocation· (δ) egress controls στο VPS (το internal metadata endpoint δεν πρέπει να είναι προσβάσιμο από το app network).
4. Αυστηρά Security Headers (η CSP ζει στην §7)
Στο next.config.ts, ρυθμίστε τις ασφαλείς κεφαλίδες (security headers):
// next.config.ts
import type { NextConfig } from 'next';
const nextConfig: NextConfig = {
async headers() {
return [
{
source: '/(.*)',
headers: [
{ key: 'X-Frame-Options', value: 'SAMEORIGIN' },
{ key: 'X-Content-Type-Options', value: 'nosniff' },
{ key: 'Referrer-Policy', value: 'strict-origin-when-cross-origin' },
{ key: 'Strict-Transport-Security', value: 'max-age=31536000; includeSubDomains; preload' },
{
key: 'Permissions-Policy',
value: 'camera=(), microphone=(), geolocation=()',
},
],
},
];
},
};
export default nextConfig;Σημείωση: στους σύγχρονους browsers υπερισχύει το CSP
frame-ancestors(βλ. §7) — τοSAMEORIGINκαλύπτει τους παλαιότερους και ταιριάζει με τη στάση του repo.
- Ορίστε
X-Frame-Options: SAMEORIGINκαιX-Content-Type-Options: nosniffσε όλες τις διαδρομές - Ενεργοποιήστε
Strict-Transport-Security(τοpreloadείναι μη αναστρέψιμο: απαιτεί HSTS σε όλα τα subdomains και η αφαίρεση από τη preload list παίρνει μήνες — βάλτε το μόνο όταν είστε σίγουροι)
5. Προστασία Δεδομένων στα React Server Components (RSC Payloads)
- ΠΟΤΕ μην περνάτε ολόκληρο το
userobject (μεpassword_hash,stripe_customer_id). - Φιλτράρετε ρητά μόνο τα δημόσια πεδία:
{ id: user.id, name: user.name, avatar: user.avatar }.
6. Προστασία CSRF σε Server Actions
Ελέγχετε πάντα την προέλευση (origin) του αιτήματος και χρησιμοποιείτε κλειδί idempotency για μεταβολές δεδομένων (mutations):
'use server'
import { headers } from 'next/headers'
export async function transferCreditsAction(formData: FormData) {
const origin = (await headers()).get('origin')
const expectedOrigin = new URL(process.env.NEXT_PUBLIC_APP_URL ?? 'http://localhost:3000').origin
let isOriginValid = false
try {
isOriginValid = origin ? new URL(origin).origin === expectedOrigin : false
} catch {
isOriginValid = false
}
if (!isOriginValid) {
return { error: 'Μη έγκυρη ή απούσα προέλευση αιτήματος.' }
}
const idempotencyKey = String(formData.get('idempotencyKey') ?? '')
if (!idempotencyKey) return { error: 'Λείπει το κλειδί idempotency.' }
return { success: true }
}7. Content Security Policy (CSP) ως Response Header & Φιλτράρισμα RSC Payloads
Η CSP επιβάλλεται μόνο ως response header — η εγγραφή της σε request headers δεν κάνει τίποτα (ο browser δεν τη διαβάζει ποτέ από το αίτημα). Η εφαρμογή στέλνει την CSP από το next.config.ts (βλ. async headers() στο repo), με script-src 'self' 'unsafe-inline':
// next.config.ts — η πραγματική στάση του repo: στατικός CSP ως response header (χωρίς nonce)
// (απόσπασμα από το headers() array)
const cspHeader = {
key: 'Content-Security-Policy',
value:
"default-src 'self'; base-uri 'self'; object-src 'none'; script-src 'self' 'unsafe-inline'; style-src 'self' 'unsafe-inline'; img-src 'self' data:; font-src 'self' data:; frame-src https://www.youtube-nocookie.com https://www.youtube.com https://player.vimeo.com; connect-src 'self' https://*.supabase.co; form-action 'self'; frame-ancestors 'self'; upgrade-insecure-requests",
}Το 'unsafe-inline' είναι συνειδητό risk-accept (σχόλιο στο next.config.ts): δεν υπάρχει HTML-capable sink (καθόλου rehype/raw HTML· το dangerouslySetInnerHTML περιορίζεται στον highlighter· τα errors γίνονται JSX-escape), οπότε κανένα script δεν φτάνει σε εκτέλεση μέσω HTML. Το src/proxy.ts είναι Supabase session-refresh proxy — αν επικολλήσετε εκεί nonce-logic που πειράζει request headers, σπάτε το auth (και η requestHeaders.set('Content-Security-Policy', …) δεν επιβάλλει τίποτα).
Εναλλακτική nonce (μόνο αν τη χρειαστείτε): μοναδικό nonce ανά αίτημα στο proxy.ts → ο ίδιος CSP μπαίνει και στα request headers (από εκεί το Next.js διαβάζει το 'nonce-…' κατά το SSR και το βάζει αυτόματα στα framework scripts) και στα response headers (εκεί τον επιβάλλει ο browser) → 'strict-dynamic' + dynamic rendering, αφού στατικές σελίδες δεν παίρνουν nonce. Στο RoboSchool το src/proxy.ts κάνει Supabase session refresh, οπότε η nonce λογική θα έμπαινε δίπλα της, όχι στη θέση της. Κόστος: σπάει το caching των responses, ρισκάρει τα Next runtime inlines και θέλει συνεχή συντήρηση σε κάθε νέο script. Μην το κάνετε εκτός αν μπει πραγματικό HTML-capable sink.
Φιλτράρετε αυστηρά τα RSC props όπως στην §5.
8. Ασφαλή Cookies + Rate Limiting
Ορίστε httpOnly; secure; sameSite=lax στα session cookies και περιορίστε τις επαναλαμβανόμενες κλήσεις ανά ενέργεια. Χωρίς throttle, κάθε δημόσιο Server Action γίνεται στόχος brute-force.
- Ορίστε
httpOnly; secure; sameSite=laxσε όλα τα session cookies - Περιορίστε τις επαναλαμβανόμενες κλήσεις κάθε δημόσιου Server Action με rate limiting
curl -sI https://example.com | grep -i content-security-policyΠοιος header επιβάλλει την CSP στον browser;
Ανακεφαλαίωση
- Η CSP επιβάλλεται μόνο ως response header· το repo στέλνει
unsafe-inlineως συνειδητό risk-accept. - Η SSRF-denylist είναι πρώτο φίλτρο — σε παραγωγή θέλετε allowlist + DNS check +
redirect: manual. - Τα Server Actions είναι δημόσια POST endpoints: Zod + auth + origin check σε κάθε mutation.