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

אימות ובקרת גישה ב-WordPress REST API

אמ;לק

מדריך רשמי לאימות בקשות REST. כל endpoint צריך גם הרשאה מתאימה לפעולה.

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

נוסף ל-VibeSec:

כותרת מקורית: REST API Authentication

$cat article.txt

>מדריך רשמי לאימות בקשות REST. כל endpoint צריך גם הרשאה מתאימה לפעולה.

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

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

במאמר זה

• ⁦Basic Authentication⁩ עם ⁦Application Passwords⁩

עם זאת, ה-REST API כולל טכניקה הנקראת nonces כדי למנוע בעיות CSRF. טכניקה זו מונעת מאתרים אחרים לאלץ אתכם לבצע פעולות ללא כוונה מפורשת מצדכם. הדבר דורש טיפול מעט שונה עבור ה-API.

עבור מפתחים המשתמשים ב-⁦Javascript⁩ ⁦API⁩ המובנה, זה מטופל באופן אוטומטי עבורך. זו הדרך המומלצת להשתמש ב-⁦API⁩ עבור תוספים וערכות נושא. מודלים מותאמים אישית של נתונים יכולים להרחיב את wp.api.models.Base כדי להבטיח שזה נשלח כראוי עבור כל בקשות מותאמות אישית.

עבור מפתחים המבצעים בקשות Ajax ידניות, יהיה צורך להעביר את ה-nonce בכל בקשה. ה-API משתמש ב-nonces כאשר הפעולה (action) מוגדרת כ-wp_rest. ניתן להעבירם ל-API באמצעות פרמטר הנתונים _wpnonce (או בנתוני ה-POST או בשאילתה עבור בקשות GET), או באמצעות הכותרת X-WP-Nonce. אם לא יסופק nonce, ה-API יגדיר את המשתמש הנוכחי כ-0 ויהפוך את הבקשה ללא מאומתת, גם אם אתם מחוברים ל-WordPress.

הערה: עד לאחרונה, לרוב התוכנות הייתה תמיכה מוגבלת בבקשות DELETE. לדוגמה, PHP אינו הופך את גוף הבקשה של בקשת DELETE ל-super global. לפיכך, אספקת ה-nonce ככותרת היא הגישה האמינה ביותר.

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

כדוגמה, כך יוצר ה-client המובנה של ה-Javascript את ה-nonce:

⁦<?php wp_localize_script( 'wp-api', 'wpApiSettings', array( 'root' => esc_url_raw( rest_url() ), 'nonce' => wp_create_nonce( 'wp_rest' ) ) );⁩

⁦options.beforeSend = function(xhr) { xhr.setRequestHeader('X-WP-Nonce', wpApiSettings.nonce); if (beforeSend) { return beforeSend.apply(this, arguments); } };⁩

הנה דוגמה לעריכת כותרת של פוסט, באמצעות ⁦jQuery⁩ ⁦AJAX⁩:

⁦$.ajax( { url: wpApiSettings.root + 'wp/v2/posts/1', method: 'POST', beforeSend: function ( xhr ) { xhr.setRequestHeader( 'X-WP-Nonce', wpApiSettings.nonce ); }, data:{ 'title' : 'Hello Moon' } } ).done( function ( response ) { console.log( response ); } );⁩

שימו לב שאין צורך לאמת את תקינות ה-nonce בתוך ה-endpoint המותאם אישית שלכם. פעולה זו מתבצעת עבורכם באופן אוטומטי ב-rest_cookie_check_errors().

⁦Basic Authentication⁩ עם ⁦Application Passwords⁩

החל מגרסה 5.6, WordPress כוללת תמיכה ב-Application Passwords, אותם ניתן להפיק דרך דף עריכת המשתמש (wp-admin -> Users -> Edit User).

ניתן להעביר את פרטי האימות לבקשות REST API המוגשות מעל https:// באמצעות Basic Auth / RFC 7617 — הנה התיעוד לשימוש בשיטה זו עם cURL.

עבור דוגמת סקריפט פשוטה לשורת הפקודה, פשוט החליפו את USERNAME, PASSWORD ו-HOSTNAME בערכים המתאימים לכם:

⁦curl --user "USERNAME:PASSWORD" https://HOSTNAME/wp-json/wp/v2/users?context=edit⁩

⁦Authentication Plugins⁩

ניתן להוסיף תוספים כדי לתמוך במצבי אימות חלופיים שיפעלו מיישומים מרוחקים. כמה תוספים לדוגמה הם ⁦OAuth⁩ 1.0a ⁦Server⁩ ו-⁦JSON⁩ ⁦Web Tokens⁩ .

יש גם תוסף ⁦Basic Authentication⁩.

שימו לב שתוסף זה דורש שליחת שם המשתמש והסיסמה שלכם עם כל בקשה, ויש להשתמש בו רק לפיתוח ובדיקה, כלומר לא בסביבת ייצור. השימוש ב-⁦Application Passwords⁩ (ראה למעלה) עדיף.

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

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

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