חזרה לפיד
articlesמקור: Security Docs — node

Next.js — הגנת נתונים וגבולות שרת/לקוח

אמ;לק

הגנת נתונים, בקרת גישה ומניעת חשיפת סודות ב-Next.js.

סיכום בעברית: מערכת VibeSec · מדיניות המקורות

נוסף ל-VibeSec:

$cat article.txt

>הגנת נתונים, בקרת גישה ומניעת חשיפת סודות ב-Next.js.

התוכן המלא בעברית

תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.

React Server Components משפרים את הביצועים ומפשטים את שליפת הנתונים, אך גם משנים את המקום והאופן שבו מתבצעת הגישה לנתונים, ובכך משנים כמה מהנחות האבטחה המסורתיות בטיפול בנתונים באפליקציות צד-לקוח.

מדריך זה יעזור לך להבין כיצד לחשוב על אבטחת מידע ב-⁦Next.js⁩ וכיצד ליישם שיטות עבודה מומלצות.

גישות לאיסוף נתונים

ישנן שלוש גישות עיקריות שאנו ממליצים עליהן לאחזור נתונים ב-Next.js, בהתאם לגודל ולגיל הפרויקט שלך:

• HTTP APIs: עבור יישומים וארגונים גדולים וקיימים.

• Component-Level Data Access: עבור אבות טיפוס ולמידה.

אנו ממליצים לבחור בגישה אחת לאיסוף נתונים ולהימנע מערבוב ביניהם. זה מבהיר גם למפתחים העובדים בבסיס הקוד שלך וגם למבקרי האבטחה למה לצפות.

HTTP APIs חיצוניים

עליך לפעול לפי מודל Zero Trust בעת אימוץ Server Components בפרויקט קיים. ניתן להמשיך לבצע קריאות לנקודות קצה (endpoints) קיימות של API, כגון REST או GraphQL, מתוך Server Components באמצעות fetch, בדיוק כפי שהיית עושה ב-Client Components.

⁦import { cookies } from 'next/headers' export default async function Page () { const cookieStore = await cookies () const token = cookieStore .get ( 'AUTH_TOKEN' )?.value const res = await fetch ( 'https://api.example.com/profile' , { headers : { Cookie : ⁩⁦AUTH_TOKEN⁩= ${ token } ⁦ , // Other headers } , }) // .... }⁩

• יש לך כבר נוהלי אבטחה במקום.

• צוותי Backend נפרדים משתמשים בשפות אחרות או מנהלים APIs באופן עצמאי.

⁦Data Access Layer⁩

עבור פרויקטים חדשים, אנו ממליצים ליצור שכבת גישה לנתונים (Data Access Layer - DAL) ייעודית. זוהי ספרייה פנימית השולטת בדרך ובתזמון שבהם נתונים נשלפים, ובאילו נתונים מועברים להקשר ה-render שלך.

• החזר אובייקטי העברת נתונים (DTOs) בטוחים ומינימליים.

גישה זו מרכזת את כל הלוגיקה של הגישה לנתונים, מקלה על אכיפת גישה עקבית ומפחיתה את הסיכון לבאגים בהרשאות. בנוסף, אתה נהנה מהיכולת לשתף מטמון בזיכרון (in-memory cache) בין חלקים שונים של בקשה.

⁦import { cache } from 'react' import { cookies } from 'next/headers' // Cached helper methods makes it easy to get the same value in many places // without manually passing it around. This discourages passing it from Server // Component to Server Component which minimizes risk of passing it to a Client // Component. export const getCurrentUser = cache ( async () => { const cookieStore = await cookies () const token = cookieStore .get ( 'AUTH_TOKEN' ) const decodedToken = await decryptAndValidate (token) // Don't include secret tokens or private information as public fields. // Use classes to avoid accidentally passing the whole object to the client. return new User ( decodedToken .id) })⁩

⁦import 'server-only' import { getCurrentUser } from './auth' function canSeeUsername (viewer : User ) { // Public info for now, but can change return true } function canSeePhoneNumber (viewer : User , team : string ) { // Privacy rules return viewer .isAdmin || team === viewer .team } export async function getProfileDTO (slug : string ) { // Don't pass values, read back cached values, also solves context and easier to make it lazy // use a database API that supports safe templating of queries const [ rows ] = await sql ⁩⁦SELECT⁩ * ⁦FROM⁩ משתמש ⁦WHERE⁩ שבלול = ${ שבלול } ⁦ const userData = rows[ 0 ] const currentUser = await getCurrentUser () // only return the data relevant for this query and not everything // <https://www.w3.org/2001/tag/doc/APIMinimization> return { username : canSeeUsername (currentUser) ? userData .username : null , phonenumber : canSeePhoneNumber (currentUser , userData .team) ? userData .phonenumber : null , } }⁩

⁦import { getProfileDTO } from '../../data/user-dto' export default async function Page ({ params }) { const { slug } = await params // This page can now safely pass around this profile knowing // that it shouldn't contain anything sensitive. const profile = await getProfileDTO (slug) ... }⁩

יש לאחסן מפתחות סודיים במשתני סביבה, אך רק ה-⁦Data Access Layer⁩ צריך לגשת אל ⁦process.env⁩ . זה שומר סודות מלהיחשף לחלקים אחרים של האפליקציה.

גישה לנתונים ברמת הרכיב

עבור אבות טיפוס ואיטרציה מהירים, ניתן למקם שאילתות מסד נתונים ישירות ב-⁦Server Components⁩.

עם זאת, גישה זו מקלה על חשיפת מידע פרטי ללקוח בטעות, למשל:

⁦import Profile from './components/profile.tsx' export default async function Page ({ params }) { const { slug } = await params const [ rows ] = await sql ⁩⁦SELECT⁩ * ⁦FROM⁩ משתמש ⁦WHERE⁩ שבלול = ${ שבלול } ⁦ const userData = rows[ 0 ] // EXPOSED: This exposes all the fields in userData to the client because // we are passing the data from the Server Component to the Client. return < Profile user = {userData} /> }⁩

⁦'use client' // BAD: This is a bad props interface because it accepts way more data than the // Client Component needs and it encourages server components to pass all that // data down. A better solution would be to accept a limited object with just // the fields necessary for rendering the profile. export default async function Profile ({ user } : { user : User }) { return ( < div > < h1 >{ user .name}</ h1 > ... </ div > ) }⁩

עליך לחטא את הנתונים לפני שתעביר אותם ל-⁦Client Component⁩:

⁦import { sql } from './db' export async function getUser (slug : string ) { const [ rows ] = await sql ⁩⁦SELECT⁩ * ⁦FROM⁩ משתמש ⁦WHERE⁩ שבלול = ${ שבלול } ⁦ const user = rows[ 0 ] // Return only the public fields return { name : user .name , } }⁩

⁦import { getUser } from '../data/user' import Profile from './ui/profile' export default async function Page ({ params , } : { params : Promise <{ slug : string }> }) { const { slug } = await params const publicProfile = await getUser (slug) return < Profile user = {publicProfile} /> }⁩

קריאת נתונים

העברת נתונים משרת ללקוח

בטעינה הראשונית, גם Server Components וגם Client Components פועלים בשרת כדי ליצור HTML. עם זאת, הם פועלים במערכות מודולים מבודדות. הדבר מבטיח ש-Server Components יוכלו לגשת לנתונים פרטיים ול-APIs, בעוד ש-Client Components לא יוכלו.

• יכול לגשת בבטחה למשתני סביבה, סודות, מסדי נתונים ו⁦APIs⁩ פנימיים.

• רצים בשרת במהלך ה-prerendering, אך חייבים לעמוד באותן הנחות אבטחה של קוד שרץ בדפדפן.

• אסור להם לגשת לנתונים בעלי הרשאות מיוחדות או למודולים שנועדו לשרת בלבד.

זה מבטיח שהאפליקציה מאובטחת כברירת מחדל, אבל אפשר לחשוף בטעות נתונים פרטיים דרך האופן שבו נתונים נשלחים או מועברים לרכיבים.

הכתמה (Tainting)

כדי למנוע חשיפה מקרית של נתונים פרטיים ללקוח, אתה יכול להשתמש ב-⁦React Taint⁩ ⁦APIs⁩:

• ⁦experimental_taintObjectReference⁩ עבור אובייקטי נתונים.

• ⁦experimental_taintUniqueValue⁩ עבור ערכים ספציפיים.

תוכל להפעיל שימוש בתכונה זו באפליקציית ה-Next.js שלך באמצעות האפשרות experimental.taint בתוך next.config.js:

⁦module . exports = { experimental : { taint : true , } , }⁩

זה מונע מהאובייקטים או הערכים ה"מוכתמים" (tainted) לעבור ללקוח. עם זאת, מדובר בשכבת הגנה נוספת בלבד; עליך עדיין לסנן ולחטא את הנתונים ב-DAL שלך לפני שתעביר אותם להקשר ה-render של React.

• כברירת מחדל, משתני סביבה זמינים רק בשרת. Next.js חושף ללקוח כל משתנה סביבה עם הקידומת NEXT_PUBLIC_. למידע נוסף.

• פונקציות ומחלקות (classes) חסומים כברירת מחדל מהעברה ל-Client Components.

מניעת ביצוע בצד הלקוח של קוד לשרת בלבד

כדי למנוע הרצה של קוד המיועד לשרת בלבד בצד הלקוח, ניתן לסמן מודול באמצעות חבילת ה-server-only:

⁦import 'server-only' //...⁩

זה מבטיח שקוד קנייני או לוגיקה עסקית פנימית יישארו בשרת על ידי גרימת שגיאת בנייה אם המודול מיובא בסביבת הלקוח.

Next.js מטפל בייבואים של server-only באופן פנימי. התוכן של חבילות אלו מ-NPM אינו בשימוש בפועל. עם זאת, אם כללי ה-linting שלך מסמנים זאת כתלות מיותרת, ייתכן שתרצה להתקין את החבילה כדי למנוע בעיות.

⁦npm install server-only⁩

קרא עוד על שרת בלבד בסעיף מניעת הרעלת סביבה.

⁦Mutating Data⁩

⁦Next.js⁩ מטפל במוטציות עם ⁦Server Actions⁩ .

תכונות אבטחה מובנות של Server Actions

כברירת מחדל, כאשר ⁦Server Action⁩ נוצר ומיוצא, ניתן להגיע אליו באמצעות בקשה ישירה של ⁦POST⁩, לא רק דרך ⁦UI⁩ של האפליקציה שלך. המשמעות היא שגם אם פונקציית ⁦Server Action⁩ או כלי שירות לא מיובאים למקום אחר בקוד שלך, עדיין ניתן לקרוא לה חיצונית.

כדי לשפר את האבטחה, ל-⁦Next.js⁩ יש את התכונות המובנות הבאות:

• מזהי פעולה מאובטחים (Secure action IDs): Next.js יוצר מזהים מוצפנים ולא דטרמיניסטיים המאפשרים ללקוח להפנות אל ה-Server Action ולקרוא לו. מזהים אלו מחושבים מחדש מעת לעת בין גרסאות בנייה (builds) לשיפור האבטחה.

• חיסול קוד מת (Dead code elimination): Server Actions שאינם בשימוש (לפי המזהים שלהם) מוסרים מ-bundle הלקוח כדי למנוע גישה ציבורית.

המזהים נוצרים במהלך הקימפול ונשמרים במטמון למשך 14 ימים לכל היותר. הם ייווצרו מחדש עם תחילת בנייה חדשה או כאשר מטמון ה-build יתבטל. שיפור אבטחה זה מפחית סיכונים במקרים שבהם חסרה שכבת אימות. עם זאת, עדיין עליך להתייחס ל-Server Actions כניתנים להפעלה דרך בקשות POST ישירות, ועליך לוודא אימות והרשאות בתוך כל אחד מהם.

⁦// app/actions.js 'use server' // If this action **is** used in our application, Next.js // will create a secure ID to allow the client to reference // and call the Server Action. export async function updateUserAction (formData) {} // If this action **is not** used in our application, Next.js // will automatically remove this code during ⁩המבנה הבא⁦ // and will not create a public endpoint. export async function deleteUserAction (formData) {}⁩

אימות קלט הלקוח

עליך תמיד לאמת קלט מהלקוח, שכן ניתן לשנות אותו בקלות. לדוגמה: נתוני טופס, פרמטרים ב-URL, כותרות ו-searchParams:

⁦// BAD: Trusting searchParams directly export default async function Page ({ searchParams }) { const isAdmin = ( await searchParams).isAdmin if (isAdmin === 'true' ) { // Vulnerable: relies on untrusted client data return < AdminPanel /> } } // GOOD: Re-verify every time import { cookies } from 'next/headers' import { verifyAdmin } from './auth' export default async function Page () { const cookieStore = await cookies () const token = cookieStore .get ( 'AUTH_TOKEN' ) const isAdmin = await verifyAdmin (token) if (isAdmin) { return < AdminPanel /> } }⁩

אימות (Authentication) והרשאות (Authorization)

בדיקת אימות ברמת העמוד אינה משתרעת על ה-⁦Server Actions⁩ המוגדר בתוכו. אמת תמיד מחדש בתוך הפעולה:

⁦import { auth } from '@/lib/auth' import { redirect } from 'next/navigation' export default async function AdminPage () { const session = await auth () if ( ! session ?. user ?.isAdmin) { redirect ( '/login' ) } return ( < form action = { async () => { 'use server' const session = await auth () if ( ! session ?. user ?.isAdmin) { throw new Error ( 'Unauthorized' ) } await db . record .deleteMany () }} > < button >Delete Records</ button > </ form > ) }⁩

בדיקת ה-auth() המודגשת בתוך הפעולה היא קריטית. ההפניה (redirect) ברמת העמוד בשורה 6 שולטת רק על ה-UI שמוצג, אך ה-Server Action הוא נקודת כניסה נפרדת וחייב לבצע אימות של הקורא באופן עצמאי.

מעבר לאימות (האם המשתמש מחובר?), זכור לבדוק הרשאות (האם למשתמש זה יש הרשאה לפעול על המשאב הספציפי הזה?). זה מונע פגיעויות של ⁦Insecure Direct Object Reference⁩ (⁦IDOR⁩):

#node#security#official-docs
קרא במקור

קריאה וכלים קשורים

אבטחת Node.js / JS / TSמונחי אבטחה והסברים בעברית