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

הצגת נתונים בטוחה ב-WordPress

אמ;לק

תיעוד escaping לפי הקשר HTML, כתובת או מאפיין. ניקוי קלט אינו תחליף לקידוד פלט.

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

נוסף ל-VibeSec:

כותרת מקורית: Escaping Data

$cat article.txt

>תיעוד escaping לפי הקשר HTML, כתובת או מאפיין. ניקוי קלט אינו תחליף לקידוד פלט.

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

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

במאמר זה

• Examples: ביצוע Escaping לכל משתנה מספרי בשימוש בכל מקום

• ביצוע Escaping למשתנה שרירותי בתוך תכונת HTML

• ביצוע Escaping ל-URL שרירותי בתוך תכונת HTML, וגם בהקשרים אחרים

• העברת משתנה שרירותי ל-⁦JavaScript⁩ באמצעות ⁦wp_localize_script⁩()

• ביצוע Escaping למשתנה שרירותי בתוך בלוק JavaScript

• ביצוע Escaping למשתנה שרירותי בתוך JavaScript מוטמע

• ביצוע Escaping למשתנה שרירותי בתוך תכונת HTML לשימוש על ידי JavaScript

• ביצוע Escaping למחרוזת שרירותית בתוך textarea ב-HTML

• ביצוע Escaping למחרוזת שרירותית בתוך תגיות HTML

• ביצוע Escaping למחרוזת שרירותית בתוך הקשר XML או XSL. ביצוע Escaping לפלט הוא תהליך של אבטחת נתונים על ידי ניקוי נתונים לא רצויים, כמו HTML פגום או תגי script. תהליך זה מסייע באבטחת הנתונים לפני הצגתם למשתמש הקצה. פונקציות Escaping: ב-WordPress יש פונקציות עזר רבות שניתן להשתמש בהן עבור רוב התרחישים הנפוצים. שימו לב היטב למה שכל פונקציה עושה, שכן חלקן יסירו HTML בעוד אחרות יאפשרו אותו. עליך להשתמש בפונקציה המתאימה ביותר לתוכן ולהקשר שבו אתה משתמש ב-echo. תמיד בצע Escaping ברגע שאתה משתמש ב-echo, לא לפני כן. esc_html() – השתמש בכל פעם שרכיב HTML מקיף קטע נתונים שמוצג. פעולה זו תסיר HTML.

⁦<h4><?php echo esc_html( $title ); ?></h4>⁩

⁦<div onclick='<?php echo esc_js( $value ); ?>' />⁩

• esc_url() – השתמש בכל ה-URLs, כולל אלה בתכונות src ו-href של אלמנט HTML.

⁦<img alt="" src="<?php echo esc_url( $media_url ); ?>" />⁩

• esc_url_raw() – השתמש בעת אחסון URL במסד הנתונים או במקרים אחרים שבהם יש צורך ב-URLs לא מקודדים.

• ⁦esc_attr⁩() - השתמש בכל דבר אחר שמודפס בתכונה של אלמנט ⁦HTML⁩.

⁦<ul class="<?php echo esc_attr( $stored_class ); ?>">⁩

• ⁦esc_textarea⁩() - השתמש בזה כדי לקודד טקסט לשימוש בתוך אלמנט textarea.

• wp_kses() – השתמש כדי לבצע Escaping בטוח לכל HTML שאינו מהימן (תוכן פוסט, תוכן תגובה וכו'). פונקציה זו משמרת HTML מורשה.

• wp_kses_post() – גרסה חלופית של wp_kses() המאפשרת אוטומטית את כל ה-HTML המותר בתוכן הפוסטים.

• wp_kses_data() – גרסה חלופית של wp_kses() המאפשרת רק את ה-HTML המותר בתגובות לפוסטים.

⁦Custom Escaping Example⁩

במקרה שאתה צריך לבצע Escaping לפלט שלך בצורה ספציפית, הפונקציה wp_kses() (נהגית "kisses") תהיה שימושית.

פונקציה זו מוודאת שרק האלמנטים, התכונות וערכי המאפיינים שצוינו ⁦HTML⁩ יופיעו בפלט שלך, ומנרמלת ישויות ⁦HTML⁩.

⁦<?php echo wp_kses_post( $partial_html ); echo wp_kses( $another_partial_html, array( 'a' => array( 'href' => array(), 'title' => array(), ), 'br' => array(), 'em' => array(), 'strong' => array(), ) ); ?>⁩

בדוגמה זו, כל התגים מלבד <a>, <br>, <em> ו-<strong> יוסרו. בנוסף, אם מועבר תג <a>, ה-Escaping מבטיח שרק ה-href וה-title יוחזרו.

תמיד בצע Escaping מאוחר

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

עדיף לבצע Escaping מאוחר מכמה סיבות:

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

• משהו עלול לשנות בטעות את המשתנה בין הזמן שהוא הוגדר לבין הזמן שהוא מוצג, מה שיוצר פגיעות פוטנציאלית.

• ביצוע Escaping מאוחר מקל על סריקת קוד אוטומטית, חוסך זמן ומקצר זמני סקירה ופריסה.

• ביצוע Escaping מאוחר ככל האפשר הופך את הקוד לחזק יותר ועמיד לעתיד.

• Escaping/casting בפלט מסיר דו-משמעות ומוסיף בהירות (תמיד תפתח עבור המתחזק הבא).

⁦// Okay, but not great. $url = esc_url( $url ); $text = esc_html( $text ); echo '<a href="'. $url . '">' . $text . '</a>'; // Much better! echo '<a href="'. esc_url( $url ) . '">' . esc_html( $text ) . '</a>';⁩

…אלא כשאי אפשר

לפעמים לא מעשי לבצע Escaping מאוחר. בכמה מקרים נדירים לא ניתן להעביר פלט ל-wp_kses(), מכיוון שבהגדרה הוא יסיר את הסקריפטים שנוצרים.

במצבים כאלה, בצע תמיד Escaping בזמן יצירת המחרוזת ואחסן את הערך במשתנה עם סיומת _escaped, _safe או _clean (למשל, $variable הופך ל-$variable_escaped או $variable_safe).

אם פונקציה אינה יכולה להוציא פלט פנימי ולבצע Escaping מאוחר, עליה להחזיר תמיד HTML "בטוח". זה מאפשר לקרוא ל-echo my_custom_script_code(); מבלי שיהיה צורך להעביר את תג הסקריפט דרך גרסה של wp_kses() שתאפשר תגיות כאלה.

Escaping עם לוקליזציה

במקום להשתמש ב-echo כדי להוציא נתונים, מקובל להשתמש בפונקציות הלוקליזציה של WordPress, כגון _e() או __().

פונקציות אלה פשוט עוטפות פונקציית לוקליזציה בתוך פונקציית בריחה:

⁦esc_html_e( 'Hello World', 'text_domain' ); // Same as echo esc_html( __( 'Hello World', 'text_domain' ) );⁩

פונקציות מסייעות אלו משלבות לוקליזציה ובריחה:

דוגמאות

ביצוע Escaping לכל משתנה מספרי בשימוש בכל מקום

⁦echo $int;⁩

תלוי אם זה מספר שלם או צף, (int) , absint() , (float) כולם נכונים ומקובלים. לפעמים, ⁦number_format⁩() או ⁦number_format_i18n⁩() עשויים להיות מתאימים יותר.

intval() , floatval() מקובלים, אך הם פונקציות מיושנות (⁦PHP4⁩).

ביצוע Escaping למשתנה שרירותי בתוך תכונת HTML

⁦echo '<div id="', $prefix, '-box', $id, '">';⁩

יש לבצע זאת עם קריאה אחת ל-esc_attr(). כאשר משתנה משמש כחלק מתכונה או כתובת URL, תמיד עדיף לבצע Escaping למחרוזת כולה, מכיוון שכך תו Escape פוטנציאלי ממש לפני המשתנה יטופל נכון.

⁦echo '<div id="', esc_attr( $prefix . '-box' . $id ), '">';⁩

⁦echo '<div id="', esc_attr( $prefix ), '-box', esc_attr( $id ), '">';⁩

הערה: יש להשתמש ב-nonces שנוצרו באמצעות ⁦wp_create_nonce⁩() גם כך אם משתמשים בתכונה ⁦HTML⁩.

ביצוע Escaping ל-URL שרירותי בתוך תכונת HTML, וגם בהקשרים אחרים

⁦echo '<a href="', $url, '">';⁩

⁦echo '<a href="', esc_url( $url ), '">';⁩

⁦echo '<a href="', esc_attr( $url ), '">'; echo '<a href="', esc_attr( esc_url( $url ) ), '">';⁩

העברת משתנה שרירותי ל-⁦JavaScript⁩ באמצעות ⁦wp_localize_script⁩()

⁦wp_localize_script( 'handle', 'name', array( 'prefix_nonce' => wp_create_nonce( 'plugin-name' ), 'ajaxurl' => admin_url( 'admin-ajax.php' ), 'errorMsg' => __( 'An error occurred', 'plugin-name' ), ) );⁩

אין צורך בבריחה, ⁦WordPress⁩ יברח מזה.

ביצוע Escaping למשתנה שרירותי בתוך בלוק JavaScript

⁦<script type="text/javascript"> var myVar = <?php echo $my_var; ?> </script>⁩

יש לבצע Escaping ל-$my_var באמצעות esc_js().

⁦<script type="text/javascript"> var myVar = <?php echo esc_js( $my_var ); ?> </script>⁩

ביצוע Escaping למשתנה שרירותי בתוך JavaScript מוטמע

⁦<a href="#" onclick="do_something(<?php echo $var; ?>); return false;">⁩

⁦<a href="#" onclick="do_something(<?php echo esc_js( $var ); ?>); return false;">⁩

ביצוע Escaping למשתנה שרירותי בתוך תכונת HTML לשימוש על ידי JavaScript

⁦<a href="#" data-json="<?php echo $var; ?>">⁩

יש לבצע Escaping ל-$var באמצעות esc_js(), json_encode() או wp_json_encode().

⁦<a href="#" data-json="<?php echo esc_js( $var ); ?>">⁩

ביצוע Escaping למחרוזת שרירותית בתוך textarea ב-HTML

⁦echo '<textarea>', $data, '</textarea>';⁩

יש לבצע Escaping ל-$data באמצעות esc_textarea().

⁦echo '<textarea>', esc_textarea( $data ), '</textarea>';⁩

ביצוע Escaping למחרוזת שרירותית בתוך תגיות HTML

⁦echo '<div>', $phrase, '</div>';⁩

זה תלוי אם $phrase צפוי להכיל ⁦HTML⁩ או לא.

• אם לא, השתמש ב-⁦esc_html⁩() או בכל אחת מהגרסאות שלו.

• אם צפוי HTML, השתמש ב-wp_kses_post(), wp_kses_allowed_html() או wp_kses() עם קבוצת תגיות ה-HTML שברצונך לאפשר.

ביצוע Escaping למחרוזת שרירותית בהקשר XML או XSL

⁦echo '<loc>', $var, '</loc>';⁩

⁦echo '<loc>', ent2ncr( $var ), '</loc>';⁩

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

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

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