חזרה לפיד
articlesמקור: WordPress Security Guides

Nonce: הגנת CSRF ללא החלפת הרשאות

אמ;לק

אסימוני WordPress מוגבלים בזמן אך אינם חד-פעמיים באמת. יש לבדוק capabilities בנפרד.

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

נוסף ל-VibeSec:

כותרת מקורית: Nonces

$cat article.txt

>אסימוני WordPress מוגבלים בזמן אך אינם חד-פעמיים באמת. יש לבדוק capabilities בנפרד.

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

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

במאמר זה

• יצירת nonce והתאמה אישית של nonces לאורחים (משתמשים לא מחוברים)

• יצירת nonce לשימוש בדרך אחרת

• אימות nonce שעבר בבקשת AJAX

• אימות nonce שעבר בהקשר אחר

• שינוי מערכת ה-nonce ושינוי משך חיי ה-nonce

Nonce הוא "מספר בשימוש פעם אחת" (number used once) המסייע בהגנה על כתובות URL וטפסים מפני סוגים מסוימים של שימוש לרעה, זדוני או אחר.

מבחינה טכנית, ה-nonces של WordPress אינם מספרים בלבד; הם hash המורכב ממספרים ואותיות. הם גם לא משמשים רק פעם אחת: יש להם "משך חיים" מוגבל שלאחריו הם פוקעים. במהלך פרק זמן זה, ייווצר אותו nonce עבור משתמש נתון בהקשר נתון. ה-nonce עבור אותה פעולה יישאר זהה עבור אותו משתמש עד לסיום מחזור החיים של ה-nonce.

אסימוני האבטחה של WordPress נקראים "nonces" (למרות ההבדלים שצוינו לעיל מ-nonces אמיתיים) מכיוון שהם משרתים מטרה דומה. הם מסייעים בהגנה מפני מספר סוגים של התקפות כולל CSRF, אך אינם מגנים מפני התקפות חוזרות (replay attacks) מכיוון שאין להם בדיקה לשימוש חד-פעמי. לעולם אין להסתמך על nonces לצורך אימות (authentication), הרשאה או בקרת גישה. הגן על הפונקציות שלך באמצעות current_user_can() , ותמיד תניח שניתן לפרוץ את ה-nonces.

למה להשתמש ב-nonce?

כדוגמה לסיבה שבגללה נעשה שימוש ב-nonce, קחו בחשבון שמסך ניהול עשוי ליצור URL שמוציא פוסט מספר 123 לאשפה.

⁦http://example.com/wp-admin/post.php?post=123&action=trash⁩

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

<img src="⁦http://example.com/wp-admin/post.php?post=123&action=trash⁩" />

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

הוספת nonce תמנע זאת. לדוגמה, כאשר משתמשים ב-nonce, ה-URL ש-WordPress מייצר עבור המשתמש נראה כך:

⁦http://example.com/wp-admin/post.php?post=123&action=trash&_wpnonce=b192fc4204⁩

אם מישהו ינסה לזרוק פוסט מספר 123 מבלי שיהיה לו ה-nonce הנכון שנוצר על ידי WordPress וניתן למשתמש, WordPress ישלח תגובת "403 Forbidden" לדפדפן.

יצירת nonce

אתה יכול ליצור nonce ולהוסיף אותו למחרוזת השאילתה ב-⁦URL⁩, אתה יכול להוסיף אותו בשדה נסתר בטופס, או שאתה יכול להשתמש בו בדרך אחרת.

עבור nonces שיש להשתמש בבקשות ⁦AJAX⁩, מקובל להוסיף את nonce לשדה נסתר, שממנו קוד ⁦JavaScript⁩ יכול להביא אותו.

שים לב שה-nonces הם ייחודיים להפעלה (session) של המשתמש הנוכחי, כך שאם משתמש מתחבר או יוצא באופן אסינכרוני, כל nonce שנמצא בדף לא יהיה תקף יותר.

התאמה אישית של nonces לאורחים (משתמשים לא מחוברים)

הליבה של WordPress מייצרת כברירת מחדל את אותו nonce עבור אורחים מכיוון שיש להם אותו מזהה משתמש (ערך 0). כלומר, זה לא מונע מאורחים התקפות CSRF. כדי לשפר את היבט האבטחה הזה עבור פעולות קריטיות, ניתן לפתח מנגנון session עבור האורחים ולהשתמש ב-hook של ה-filter בשם nonce_user_logged_out כדי להחליף את ערך מזהה המשתמש 0 ב-ID אקראי אחר ממנגנון ה-session.

הוספת nonce ל-URL

כדי להוסיף nonce ל-⁦URL⁩, התקשר ל-⁦wp_nonce_url⁩() תוך ציון ה-⁦URL⁩ החשוף ומחרוזת המייצגת את הפעולה. לְדוּגמָה:

⁦$complete_url = wp_nonce_url( $bare_url, 'trash-post_'.$post->ID );⁩

להגנה מרבית, ודא שהמחרוזת המייצגת את הפעולה היא ספציפית ככל האפשר.

כברירת מחדל, ⁦wp_nonce_url⁩() מוסיף שדה בשם _wpnonce . ניתן לציין שם אחר בקריאת הפונקציה. לְדוּגמָה:

⁦$complete_url = wp_nonce_url( $bare_url, 'trash-post_'.$post->ID, 'my_nonce' );⁩

הוספת נון לטופס

כדי להוסיף nonce לטופס, התקשר אל ⁦wp_nonce_field⁩() תוך ציון מחרוזת המייצגת את הפעולה. כברירת מחדל ⁦wp_nonce_field⁩() מייצר שני שדות מוסתרים, אחד שהערך שלו הוא ה-nonce ואחד שהערך שלו הוא ה-⁦URL⁩ הנוכחי (המפנה), וזה מהדהד את התוצאה. לדוגמה, השיחה הזו:

⁦wp_nonce_field( 'delete-comment_'.$comment_id );⁩

⁦<input type="hidden" id="_wpnonce" name="_wpnonce" value="796c7766b1" /> <input type="hidden" name="_wp_http_referer" value="/wp-admin/edit-comments.php" />⁩

להגנה מרבית, ודא שהמחרוזת המייצגת את הפעולה היא ספציפית ככל האפשר.

ניתן לציין שם אחר לשדה ה-nonce, לציין שאין ברצונך בשדה מפנה (referrer), או שהתוצאה תוחזר במקום להודפס למסך. לפרטים על התחביר, ראה: wp_nonce_field().

יצירת nonce לשימוש בדרך אחרת

כדי ליצור nonce לשימוש בדרך אחרת, קרא ⁦wp_create_nonce⁩() תוך ציון מחרוזת המייצגת את הפעולה. לְדוּגמָה:

⁦$nonce = wp_create_nonce( 'my-action_'.$post->ID );⁩

זה פשוט מחזיר את ה-nonce עצמו. לדוגמה: 295a686963

להגנה מרבית, ודא שהמחרוזת המייצגת את הפעולה היא ספציפית ככל האפשר.

אימות nonce

ניתן לאמת nonce שהועבר ב-URL, בטופס במסך ניהול, בבקשת AJAX או בהקשר אחר.

אימות nonce שהועבר ממסך ניהול: כדי לאמת nonce שהועבר ב-URL או בטופס במסך ניהול, קרא ל-check_admin_referer() וציין את המחרוזת המייצגת את הפעולה.

⁦check_admin_referer( 'delete-comment_'.$comment_id );⁩

קריאה זו בודקת את ה-nonce ואת המפנה, ואם הבדיקה נכשלת היא נוקטת בפעולה הרגילה (מפסיקה את ביצוע הסקריפט עם תגובת "403 ⁦Forbidden⁩" והודעת שגיאה).

אם לא השתמשת בשם השדה המוגדר כברירת מחדל (_wpnonce) כאשר יצרת את ה-nonce, ציין את שם השדה.

⁦check_admin_referer( 'delete-comment_'.$comment_id, 'my_nonce' );⁩

אימות nonce שעבר בבקשת AJAX

כדי לאמת אי-נון שהועבר בבקשה ⁦AJAX⁩, התקשר אל ⁦check_ajax_referer⁩() תוך ציון המחרוזת המייצגת את הפעולה. לְדוּגמָה:

⁦check_ajax_referer( 'process-comment' );⁩

קריאה זו בודקת את ה-nonce (אך לא את המפנה), ואם הבדיקה נכשלת, כברירת מחדל היא מפסיקה את ביצוע הסקריפט.

אם לא השתמשת באחד משמות השדות המוגדרים כברירת מחדל (_wpnonce או _ajax_nonce) כאשר יצרת את ה-nonce, או אם ברצונך לבצע פעולה אחרת במקום לסיים את הביצוע, תוכל לציין פרמטרים נוספים. לפרטים, ראה: ⁦check_ajax_referer⁩() .

אימות nonce שעבר בהקשר אחר

כדי לאמת nonce שהועבר בהקשר אחר, קרא ל-wp_verify_nonce() וציין את ה-nonce ואת המחרוזת המייצגת את הפעולה.

⁦wp_verify_nonce( $_POST['my_nonce'], 'process-comment'.$comment_id );⁩

אם התוצאה שגויה, אל תמשיך בעיבוד הבקשה. במקום זאת, בצע פעולה מתאימה. הפעולה הרגילה היא קריאה ל-⁦wp_nonce_ays⁩() , אשר שולחת תגובת "403 ⁦Forbidden⁩" לדפדפן.

שינוי מערכת ה-nonce

אתה יכול לשנות את מערכת nonce על ידי הוספת פעולות ומסננים שונים.

שינוי משך החיים של ה-nonce

כברירת מחדל, ל-nonce יש חיים של יום אחד. לאחר מכן, ה-nonce אינו תקף יותר גם אם הוא תואם למחרוזת הפעולה. כדי לשנות את משך החיים, הוסף מסנן ⁦nonce_life⁩ המציין את משך החיים בשניות.

לדוגמה, כדי לשנות את משך החיים לארבע שעות:

⁦add_filter( 'nonce_life', function () { return 4 * HOUR_IN_SECONDS; } );⁩

ביצוע אימות נוסף

כדי לבצע אימות נוסף כאשר ⁦check_admin_referrer⁩() מצא שה-nonce והמפנה תקפים, הוסף פעולה ⁦check_admin_referer⁩.

⁦function wporg_additional_check ( $action, $result ) { ... } add_action( 'check_admin_referer', 'wporg_additional_check', 10, 2 );⁩

עבור ⁦check_ajax_referer⁩() הוסף פעולה ⁦check_ajax_referer⁩ באותו אופן.

שינוי הודעת השגיאה

אתה יכול לשנות את הודעת השגיאה שנשלחה כאשר אי-הודעה אינה חוקית, באמצעות מערכת התרגום. לְדוּגמָה:

⁦function my_nonce_message ($translation) { if ($translation === 'Are you sure you want to do this?') { return 'No! No! No!'; } return $translation; } add_filter('gettext', 'my_nonce_message');⁩

מידע נוסף

חלק זה מכיל מידע נוסף על מערכת ה-nonce ב-⁦WordPress⁩ שעשוי להיות שימושי מדי פעם.

משך חיי ה-nonce

שים לב שכמו ש-nonce של WordPress אינו "מספר שמשתמשים בו פעם אחת", משך החיים של ה-nonce אינו באמת משך חיים רגיל. WordPress משתמשת במערכת עם שני "טיקים" (כל אחד הוא מחצית ממשך החיים) ומאמתת nonces מהטיק הנוכחי ומהטיק הקודם. בהגדרות ברירת המחדל (משך חיים של 24 שעות) זה אומר שמידע הזמן ב-nonce קשור לכמה פרקי זמן של 12 שעות חלפו מאז עידן ה-Unix. משמעות הדבר היא של-nonce שנוצר בין הצהריים לחצות יהיה משך חיים עד הצהריים למחרת. משך החיים בפועל משתנה לפיכך בין 12 ל-24 שעות.

כאשר nonce חוקי, הפונקציות שמאמתות nonces מחזירות את מספר הסימון הנוכחי, 1 או 2. תוכל להשתמש במידע זה, למשל, כדי לרענן את nonces שנמצאות בסימון השני שלהם כדי שלא יפוג.

אבטחת nonce

Nonces נוצרים באמצעות מפתח ומלח שהם ייחודיים לאתר שלך אם התקנת את ⁦WordPress⁩ כהלכה. ⁦NONCE_KEY⁩ ו-⁦NONCE_SALT⁩ מוגדרים בקובץ ⁦wp-config.php⁩ שלך, והקובץ מכיל הערות המספקות מידע נוסף.

לעולם אין להסתמך על nonces לצורך אימות או הרשאה, או עבור בקרת גישה. הגן על הפונקציות שלך באמצעות current_user_can() , ותמיד תניח שניתן לפרוץ את ה-nonces.

החלפת מערכת nonce

חלק מהפונקציות המרכיבות את מערכת nonce ניתנות לחיבור כך שתוכל להחליף אותן על ידי אספקת פונקציות משלך.

כדי לשנות את אופן האימות של בקשות מנהל או ⁦AJAX⁩ בקשות, אתה יכול להחליף את ⁦check_admin_referrer⁩() או ⁦check_ajax_referrer⁩() , או את שניהם.

כדי להחליף את מערכת nonce עם מערכת nonce אחרת, אתה יכול להחליף את ⁦wp_create_nonce⁩(), ⁦wp_verify_nonce⁩() ו-⁦wp_nonce_tick⁩() .

פונקציות nonce: wp_nonce_ays(), wp_nonce_field(), wp_nonce_url(), wp_verify_nonce(), wp_create_nonce(), check_admin_referer(), check_ajax_referer(), wp_referer_field()

Hooks של nonce: nonce_life, nonce_user_logged_out, explain_nonce_(verb)-(noun), check_admin_referer

#wordpress#security#guide
קרא במקור

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

אבטחת WordPressמונחי אבטחה והסברים בעברית