Laravel — הגנת CSRF
אמ;לק
מנגנון CSRF הרשמי של Laravel והגנה על פעולות עם עוגיות.
סיכום בעברית: מערכת VibeSec · מדיניות המקורות
נוסף ל-VibeSec:
>מנגנון CSRF הרשמי של Laravel והגנה על פעולות עם עוגיות.
התוכן המלא בעברית
תרגום אוטומטי מהמקור; מונחים טכניים נשארו באנגלית. לנוסח המחייב — הכתבה המקורית.
אזהרה: אתה מעיין בתיעוד עבור גרסה ישנה של Laravel. שקול לשדרג את הפרויקט שלך ל-Laravel 13.x.
מָבוֹא
זיופי בקשות חוצות אתרים הם סוג של ניצול זדוני לפיו פקודות לא מורשות מבוצעות בשם משתמש מאומת. למרבה המזל, Laravel מקל על ההגנה על האפליקציה שלך מפני התקפות של זיוף בקשות חוצות אתרים (CSRF).
הסבר על הפגיעות
אם אינך מכיר את נושא זיוף בקשות חוצות אתרים (CSRF), הבה נדון בדוגמה לאופן שבו ניתן לנצל פגיעות זו. דמיין שלאפליקציה שלך יש נתיב /user/email שמקבל בקשת POST לשינוי כתובת האימייל של המשתמש המאומת. רוב הסיכויים שנתיב זה מצפה לשדה קלט המכיל את כתובת האימייל החדשה שהמשתמש מעוניין להגדיר.
ללא הגנת CSRF, אתר זדוני עלול ליצור טופס HTML המפנה לנתיב /user/email באפליקציה שלך ושולח את כתובת האימייל של התוקף:
1 < form action = " https://your-application.com/user/email " method = " POST " > 2 < input type = " email " value = " [email protected] " > 3 </ form > 4 5 < script > 6 document . forms [ 0 ] . submit (); 7 </ script > <form action="https://your-application.com/user/email" method="POST"> <input type="email" value=" [email protected] "> </form> <script> document.forms[0].submit(); </script>
אם האתר הזדוני שולח את הטופס באופן אוטומטי בעת טעינת הדף, המשתמש הזדוני צריך רק לפתות משתמש תמים של האפליקציה שלך לבקר באתר שלו, וכתובת האימייל שלו תשתנה באפליקציה שלך.
כדי למנוע פגיעות זו, עלינו לבדוק כל בקשת POST, PUT, PATCH או DELETE נכנסת עבור ערך סשן סודי שהאפליקציה הזדונית אינה יכולה לגשת אליו.
מניעת בקשות CSRF
Laravel מייצרת אוטומטית אסימון (token) CSRF עבור כל סשן משתמש פעיל המנוהל על ידי האפליקציה. אסימון זה משמש לאימות שהמשתמש המאומת הוא זה שמבצע בפועל את הבקשות לאפליקציה. מכיוון שהאסימון מאוחסן בסשן של המשתמש ומשתנה בכל פעם שהסשן נוצר מחדש, אפליקציה זדונית אינה יכולה לגשת אליו.
ניתן לגשת לאסימון ה-CSRF של הסשן הנוכחי דרך הסשן של הבקשה או דרך פונקציית העזר csrf_token:
1 use Illuminate\Http\ Request ; 2 3 Route :: get ( ' /token ' , function ( Request $request ) { 4 $token = $request -> session () -> token (); 5 6 $token = csrf_token (); 7 8 // ... 9 }); use Illuminate\Http\Request; Route::get('/token', function (Request $request) { $token = $request->session()->token(); $token = csrf_token(); // ... });
בכל פעם שאתה מגדיר טופס HTML מסוג POST, PUT, PATCH או DELETE באפליקציה שלך, עליך לכלול שדה CSRF _token מוסתר בטופס כדי שתוכנת התווך (middleware) של הגנת ה-CSRF תוכל לאמת את הבקשה. לנוחותך, ניתן להשתמש בהנחיית Blade בשם @csrf כדי ליצור את שדה הקלט המוסתר:
1 < form method = " POST " action = " /profile " > 2 @csrf 3 4 <!-- Equivalent to... --> 5 < input type = " hidden " name = " _token " value = " {{ csrf_token () }} " /> 6 </ form > <form method="POST" action="/profile"> @csrf <!-- Equivalent to... --> <input type="hidden" name="_token" value="{{ csrf_token() }}" /> </form>
תוכנת התווך Illuminate\Foundation\Http\Middleware\ValidateCsrfToken, הכלולה כברירת מחדל בקבוצת תוכנות התווך של ה-web, תאמת אוטומטית שהאסימון בקלט הבקשה תואם לאסימון המאוחסן בסשן. כאשר שני האסימונים הללו תואמים, אנו יודעים שהמשתמש המאומת הוא זה שיזם את הבקשה.
אסימוני CSRF ו-SPAs
אם אתה בונה SPA שמשתמש ב-Laravel בתור API אחורי, עליך לעיין בתיעוד Laravel Sanctum לקבלת מידע על אימות עם API והגנה מפני פגיעויות CSRF.
החרגת כתובות (URIs) מהגנת CSRF
לעיתים תרצה להחריג קבוצת כתובות (URIs) מהגנת ה-CSRF. לדוגמה, אם אתה משתמש ב-Stripe כדי לעבד תשלומים ונעזר במערכת ה-webhook שלהם, תצטרך להחריג את נתיב ה-webhook של Stripe מהגנת ה-CSRF, שכן Stripe לא תדע איזה אסימון CSRF לשלוח לנתיבים שלך.
בדרך כלל, עליך למקם נתיבים מסוג זה מחוץ לקבוצת תוכנות התווך של ה-web ש-Laravel מחילה על כל הנתיבים בקובץ routes/web.php. עם זאת, תוכל גם להחריג נתיבים ספציפיים על ידי העברת ה-URIs שלהם למתודה validateCsrfTokens בקובץ bootstrap/app.php של האפליקציה שלך:
1 -> withMiddleware ( function ( Middleware $middleware ) : void { 2 $middleware -> validateCsrfTokens (except: [ 3 ' stripe/* ' , 4 ' http://example.com/foo/bar ' , 5 ' http://example.com/foo/* ' , 6 ]); 7 }) ->withMiddleware(function (Middleware $middleware): void { $middleware->validateCsrfTokens(except: [ 'stripe/*', 'http://example.com/foo/bar', 'http://example.com/foo/*', ]); })
מטעמי נוחות, תוכנת התווך של ה-CSRF מושבתת אוטומטית עבור כל הנתיבים בעת הרצת בדיקות.
X-CSRF-TOKEN
בנוסף לבדיקת אסימון ה-CSRF כפרמטר POST, תוכנת התווך Illuminate\Foundation\Http\Middleware\ValidateCsrfToken, הנכללת כברירת מחדל בקבוצת תוכנות התווך של ה-web, תבדוק גם את כותרת הבקשה X-CSRF-TOKEN. תוכל, למשל, לאחסן את האסימון ב-meta tag של HTML:
1 < meta name = " csrf-token " content = " {{ csrf_token () }} " > <meta name="csrf-token" content="{{ csrf_token() }}">
לאחר מכן, תוכל להורות לספרייה כמו jQuery להוסיף אוטומטית את האסימון לכל כותרות הבקשות. זה מספק הגנת CSRF פשוטה ונוחה עבור אפליקציות מבוססות AJAX המשתמשות בטכנולוגיית JavaScript ישנה:
1 $ . ajaxSetup ({ 2 headers: { 3 ' X-CSRF-TOKEN ' : $ ( ' meta[name="csrf-token"] ' ) . attr ( ' content ' ) 4 } 5 }); $.ajaxSetup({ headers: { 'X-CSRF-TOKEN': $('meta[name="csrf-token"]').attr('content') } });
X-XSRF-TOKEN
Laravel מאחסנת את אסימון ה-CSRF הנוכחי בעוגייה מוצפנת מסוג XSRF-TOKEN, הנכללת בכל תגובה המופקת על ידי הפריימוורק. אתה יכול להשתמש בערך העוגייה כדי להגדיר את כותרת הבקשה X-XSRF-TOKEN.
עוגייה זו נשלחת בעיקר לנוחיות המפתחים, שכן חלק מפריימוורקים וספריות JavaScript, כמו Angular ו-Axios, מציבים אוטומטית את ערכה בכותרת X-XSRF-TOKEN בבקשות מאותו מקור (same-origin).
כברירת מחדל, הקובץ resources/js/bootstrap.js כולל את ספריית Axios HTTP אשר תשלח עבורך באופן אוטומטי את הכותרת X-XSRF-TOKEN.
בעמוד הזה
Laravel היא הדרך היעילה ביותר לבנות, לפרוס ולנטר תוכנה.
קריאה וכלים קשורים
אבטחת PHP / Laravel- Dependabot — עדכונים אוטומטיים לתלויות פגיעות
- Enlightn — בדיקות אבטחה וביצועים ל-Laravel; בדקו התאמה לגרסת המסגרת.
- GitGuardian — זיהוי סודות ומפתחות שדלפו לקוד
- פרצת אבטחה קריטית ב-PHP: מה בעלי אתרי WordPress חייבים לעשות
- חולשות קריטיות ב-PHP: כך תגנו על האתר שלכם
- חולשת אבטחה חדשה ב-PHP: מה בעלי אתרים צריכים לדעת