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

OWASP — מניעת XSS

אמ;לק

קידוד פלט לפי הקשר וניקוי HTML כאשר נדרש; רלוונטי גם ל-React.

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

נוסף ל-VibeSec:

$cat article.txt

>קידוד פלט לפי הקשר וניקוי HTML כאשר נדרש; רלוונטי גם ל-React.

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

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

הקדמה ¶

דף הצ'יט הזה עוזר למפתחים למנוע פגיעויות ⁦XSS⁩.

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

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

⁦Framework Security⁩ ¶

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

• שימוש בפתחי מילוט (escape hatches) שבהם מסגרות משתמשות כדי לבצע מניפולציה ישירה על ה-DOM

• שימוש ב-dangerouslySetInnerHTML של React ללא חיטוי (sanitization) של ה-HTML

• ערכי URL לא מאומתים: React 19 חוסמת כתובות javascript: ב-src וב-href, אך זה לא מחליף את הצורך באימות URL ספציפי לאפליקציה

• פונקציות ⁦bypassSecurityTrustAs⁩* של Angular

• המאפיין inner-h-t-m-l והפונקציה htmlLiteral של Polymer

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

כאשר אתה משתמש במסגרת אינטרנט מודרנית, עליך לדעת כיצד היא מונעת XSS והיכן קיימים בה פערים. יהיו מקרים שבהם תצטרך לבצע פעולות מחוץ להגנות שמספקת המסגרת, מה שאומר ש-Output Encoding וחיטוי HTML יכולים להיות קריטיים. OWASP תפיק דפי צ'יט ספציפיים למסגרות עבור React, Vue ו-Angular.

⁦XSS⁩ ⁦Defense Philosophy⁩ ¶

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

כדי למנוע XSS, כל מקום שבו מתווספים נתונים לא מהימנים לדף זקוק להגנה. הכיסוי הוא מה שקובע: אפליקציה שמגינה על 99 מקומות ומפספסת אחד עדיין נשארת פגיעה. מסגרות רבות מבצעות בריחה (escaping) לכל ערך שהן מציגות כברירת מחדל, בין אם הוא מהימן ובין אם לא. אנו ממליצים על גישה זו, מכיוון שהיא אינה תלויה בקבלת החלטה נכונה לגבי אילו נתונים אינם מהימנים.

ההגנה המתאימה תלויה באופן השימוש בנתונים. העדיפו APIs בטוחים שמתייחסים לנתונים כטקסט. בעת הכנסת נתונים להקשר המפרש תחביר, השתמש ב-Output Encoding המתאים להקשר. כאשר אפליקציה צריכה לקבל HTML שנוצר על ידי משתמש, השתמש ברכיב חיטוי (sanitizer) מתוחזק ל-HTML. אימות קלט יכול לאכוף פורמטים צפויים, אך הוא אינו מחליף הגנות אלו. תכונות האבטחה של המסגרת עוזרות למנוע XSS, אך APIs לא בטוחים ומעקפים של המסגרת עלולים להחזיר פגיעויות.

⁦Output Encoding⁩ ¶

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

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

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

ישנן שיטות Output Encoding רבות ושונות מכיוון שדפדפנים מנתחים HTML, JS, URLs ו-CSS בצורות שונות. שימוש בשיטת קידוד שגויה עלול להוביל לחולשות אבטחה או לפגוע בתקינות האפליקציה.

⁦Output Encoding⁩ עבור "⁦HTML⁩ הקשרים" ¶

"הקשר HTML" (HTML Context) מתייחס להכנסת משתנה בין שתי תגיות HTML בסיסיות כמו <div> או <b>. לדוגמה:

⁦< div > $varUnsafe </ div >⁩

תוקף יכול לשנות נתונים שמעובדים כ-$⁦varUnsafe⁩ . זה עלול להוביל להתקפה שתתווסף לדף אינטרנט. לְדוּגמָה:

⁦< div > < script > alert ⁩1⁦ </ script > </ div > // Example Attack⁩

על מנת להוסיף משתנה להקשר ⁦HTML⁩ בבטחה לתבנית אינטרנט, השתמש בקידוד ישות ⁦HTML⁩ עבור משתנה זה.

הנה כמה דוגמאות לערכים מקודדים עבור תווים ספציפיים:

בעת הצגת טקסט עם ⁦JavaScript⁩, הקצה אותו למאפיין ⁦textContent⁩ של אלמנט רגיל כגון <div> . זה יוצר צומת טקסט ללא ניתוח ⁦HTML⁩; זה לא ⁦HTML-encode⁩ הערך. העבר את הטקסט המקורי מבלי לקודד אותו מראש. אל תשתמש בו עבור תוכן סקריפט או סגנון לא מהימן; ⁦HTMLScriptElement⁩.⁦textContent⁩ מגדיר קוד הפעלה.

⁦& &amp; < &lt; > &gt; " &quot; ' &#x27;⁩

⁦Output Encoding⁩ עבור "⁦HTML⁩ ⁦Attribute Contexts⁩" ¶

השתמש בקידוד תכונה ⁦HTML⁩ עבור נתונים המוכנסים לתכונות טקסט רגילות, כגון כותרת או ערך . שמור על שמות אלמנטים ומאפיינים קבועים. תכונות המכילות ⁦URLs⁩, ⁦CSS⁩, ⁦HTML⁩, או ⁦JavaScript⁩ זקוקות לפקדים עבור ההקשרים הנוספים האלה.

מציין המיקום שלהלן מייצג נתונים שכבר מקודדים עבור תכונה ⁦HTML⁩ במירכאות:

⁦< input value = "ENCODED DATA" >⁩

הקף תמיד את ערכי המאפיינים במרכאות כפולות (") או בודדות ('). השתמש במקודד המאפיינים של המסגרת או הספרייה שלך כדי להגן על המרכאות הסובבות ועל תחביר HTML אחר. רווחים אינם מסיימים ערך מצוטט, לכן קידוד של כל רווח או תו שאינו אלפאנומרי אינו נחוץ. חוקי הניתוח של HTML מבדילים בין ערכים מצוטטים לערכים שאינם מצוטטים, שבהם רווח לבן מסיים את הערך.

קידוד תכונת HTML לבדו אינו מגן על JavaScript בתוך מאפיין של מטפל אירועים (event-handler attribute): מנתח ה-HTML מפענח הפניות לתווים לפני שה-JavaScript מתפרש. קידוד תווים נוספים כישויות HTML אינו מסיר את ההקשר השני הזה. העדיפו שימוש ב-addEventListener() עם פונקציות מטפל מהימנות והעבירו ערכי משתמש כנתונים בלבד. עבור תבניות Legacy בלתי נמנעות, עקוב אחר ההקשר המתועד של הספריה לשימוש ב-JavaScript-in-HTML עבור נתונים בתוך מחרוזת JavaScript הכלואה בתוך מאפיין HTML מצוטט; מקודד לא יכול להפוך קוד מטפל לא מהימן לבטוח.

בעת עדכון אלמנט קיים מ-JavaScript, הפקודה element.setAttribute("title", value) מקצה את הערך ישירות; היא אינה מבצעת HTML-encoding. אל תקודד מראש ערך זמן-ריצה עבור מאפיין טקסט פשוט זה. שמור את שם המאפיין קבוע ובטוח: מאפייני מטפל אירועים ו-srcdoc יכולים לפרש את הערכים שלהם כקוד או כ-HTML.

⁦Output Encoding⁩ עבור "⁦JavaScript Contexts⁩" ¶

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

⁦< script > const message = "ENCODED DATA" ;</ script >⁩

אל תכניס קוד, מזהים או ביטויים שאינם מהימנים. השתמש במקודד מתוחזק ופעל לפי חוזה ההקשר שלו במקום לבצע בריחה ממרכאות באופן ידני או להחיל כלל \xHH גנרי. מדריך ההקשר של OWASP Java Encoder מבחין בין בלוקים של סקריפט, מחרוזות של מטפלי אירועים ו-JavaScript עצמאי. תמיכה במילוליות תבניתיות (template literals) רגילות תלויה בספריה ובגרסה; אין זה מרמז על תמיכה בתבניות מתויגות (tagged templates) או בגופי ביטוי ${...}.

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

עבור ⁦JSON⁩, ודא שהכותרת ⁦Content-Type⁩ היא ⁦application/json⁩ ולא ⁦text/html⁩ כדי למנוע ⁦XSS⁩.

⁦Output Encoding⁩ עבור "⁦CSS⁩ הקשרים" ¶

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

⁦< style > selector { property : $ varUnsafe ; } </ style > < style > selector { property : "$varUnsafe" ; } </ style > < span style = "property : $varUnsafe" > Oh no </ span >⁩

כאשר יש צורך בעיצוב דינמי, השתמש ב-CSSOM API כגון element.style.setProperty() עם שם מאפיין קבוע וערך המוגבל על ידי רשימת היתרים (allowlist) ספציפית לאותו מאפיין. ה-API מגדיר ערך מאפיין CSS, אך אינו מאמת אם ערך זה מתאים לדרישות האבטחה של האפליקציה שלך. מאפיינים שיכולים לטעון משאבים, כגון background-image, דורשים אימות URL נפרד מול הסכימות והיעדים שהאפליקציה שלך מתירה.

⁦Output Encoding⁩ עבור "⁦URL⁩ הקשרים" ¶

"⁦URL⁩ הקשרים" מתייחס למשתנים הממוקמים לתוך ⁦URL⁩. לרוב, מפתח יוסיף פרמטר או ⁦URL⁩ פרגמנט לבסיס ⁦URL⁩ שיוצג או נעשה בו שימוש בפעולה כלשהי. השתמש ב-⁦URL⁩ ⁦Encoding⁩ עבור תרחישים אלו.

⁦< a href = "http://www.owasp.org?test=$varUnsafe" > link </ a >⁩

יש לקודד את כל התווים בפורמט הקידוד %⁦HH⁩. ודא שכל התכונות מצוטטות במלואן, זהה ל-⁦JS⁩ ו-⁦CSS⁩.

⁦Common Mistake⁩ ¶

יהיו מצבים שבהם אתה משתמש ב-⁦URL⁩ בהקשרים שונים. הנפוץ ביותר הוא הוספתו לתכונה href או src של תג <a>. בתרחישים אלה, עליך לבצע קידוד ⁦URL⁩ ואחריו קידוד תכונה ⁦HTML⁩.

⁦url = "https://site.com?data=" + urlencode(parameter) < a href = 'attributeEncode(url)' > link </ a >⁩

בעת שימוש ב-⁦JavaScript⁩ כדי לבנות ⁦URL⁩, השתמש ב-⁦encodeURIComponent⁩() כדי לקודד כל ערך של פרמטר שאילתה לא מהימן. הוא מקודד רכיב ⁦URL⁩; זה לא מאמת ⁦URL⁩ שלם.

Base64url מייצג בתים באמצעות אלפבית ידידותי ל-URL. פרוטוקולים כגון JSON Web Tokens (JWTs) משתמשים בצורה לא מרופדת (unpadded) ש-encodeURIComponent() מותירה ללא שינוי. השתמש ב-base64url רק כאשר המקבל מצפה לכך. לאחר הפענוח, החל את ה-Output Encoding או את החיטוי הנדרשים בהקשר היעד.

⁦Dangerous Contexts⁩ ¶

קידוד הפלט אינו מושלם. זה לא תמיד ימנע את ⁦XSS⁩. מיקומים אלו ידועים כהקשרים מסוכנים. הקשרים מסוכנים כוללים:

⁦< script > Directly in a script </ script > <!-- Inside an HTML comment --> < style > Directly in CSS </ style > < div ToDefineAnAttribute = test /> < ToDefineATag href = "/test" />⁩

• כאשר ⁦URLs⁩ מטופלים בקוד כגון ⁦CSS⁩ { background-url : "javascript:alert(xss)"; }

• קוד JavaScript של מטפל אירועים לא מהימן (לדוגמה, ערך שלם של onclick). העדיפו פונקציות מהימנות הרשומות באמצעות addEventListener(); עיין בסעיף HTML Attribute Contexts לאינטרפולציה של מחרוזות Legacy.

• פונקציות ⁦JS⁩ לא בטוחות כמו eval() , ⁦setInterval⁩() , ⁦setTimeout⁩()

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

חיטוי HTML (HTML Sanitization)

כאשר משתמשים צריכים לכתוב HTML, מפתחים עשויים לאפשר להם לשנות את הסגנון או המבנה של התוכן בתוך עורך WYSIWYG. Output Encoding במקרה זה ימנע XSS, אך הוא ישבור את הפונקציונליות המיועדת של האפליקציה והסגנון לא יוצג. במקרים אלה, יש להשתמש בחיטוי HTML.

חיטוי HTML יסיר קוד HTML מסוכן ממשתנה ויחזיר מחרוזת HTML בטוחה. OWASP ממליץ על DOMPurify עבור חיטוי HTML.

⁦let clean = DOMPurify . sanitize ( dirty );⁩

יש עוד כמה דברים שצריך לקחת בחשבון:

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

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

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

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