المنهج الدراسي الدرس 63 من 156 · حقن النصوص البرمجية (XSS)
حقن النصوص البرمجية (XSS)

القوالب التي يتم الهروب منها بشكل افتراضي

لماذا هذا مهم نادرا ما ستقوم بلصق HTML يدويا. المواقع الحقيقية تستخدم القوالب، وأنظمة القوالب الجيدة تقوم بعمل escape لكل قيمة بدلا عنك. وظيفتك هي في الغالب عدم إيقاف ذلك بالخطأ، والتعرف على القلة من المفاتيح التي تفعل ذلك.

تشبيه: سيارة تفرمل من أجلك

تفرمل السيارات الحديثة تلقائيا إذا كنت على وشك الاصطدام بشيء ما. يمكنك إيقاف هذه الميزة، وأحيانا يكون هناك سبب وجيه لذلك. لكن في كل مرة تكون فيها الميزة متوقفة، يجدر بك السؤال عن السبب. الهروب التلقائي مماثل لذلك: يكون مفعلا بشكل افتراضي في الأدوات الجيدة، مع وجود طرق قليلة واضحة التسمية لإيقافه.

Template: ملف HTML يحتوي على فجوات، مثل {{ name }}، يقوم الخادم بملئها لكل صفحة. محرك template engine هو الكود الذي يملأ الفجوات.

الهروب التلقائي: يقوم محرك القوالب بترميز كل قيمة يضعها في فجوة، إلا إذا أخبرته أن القيمة آمنة بالفعل.

Django

تهرّب قوالب Django كل {{ value }} افتراضياً: <، و>، و&، و" و'، الخمسة نفسها التي هرّبتها يدوياً. صفحات الدورة في هذا الموقع مبنية بهذه الطريقة.

{# safe: escaped automatically #}
<p>{{ review.text }}</p>
<input name="q" value="{{ query }}">

{# the dangerous switches: each one turns escaping off #}
{{ review.text|safe }}
{% autoescape off %}{{ review.text }}{% endautoescape %}

في كود Python، mark_safe(text) يخبر Django "هذا هو HTML بالفعل، لا تقم بعمل escape له". استخدمه فقط على النص الذي كتبه كودك الخاص. عندما تحتاج إلى بناء قطعة صغيرة من HTML في Python، استخدم format_html، والذي يقوم بعمل escape لكل قيمة تمررها فيه:

from django.utils.html import format_html
from django.utils.safestring import mark_safe

bad = mark_safe(f"<b>{user_name}</b>")            # user_name is NOT escaped
good = format_html("<b>{}</b>", user_name)          # user_name IS escaped

لتمرير البيانات إلى JavaScript الخاصة بصفحتك، استخدم فلتر json_script بدلا من لصق القيم في كتلة <script>. يقوم هذا الفلتر بكتابة البيانات بصيغة JSON بطريقة تمنع إغلاق وسم script مبكرا.

Jinja (و Flask)

Jinja هو محرك قوالب Python شائع آخر. إعداده الافتراضي مختلف: فإن Environment() لا يقوم بـ not escape. قم بتفعيله، كما يفعل Flask لـ .html templates:

from jinja2 import Environment, select_autoescape

env = Environment(autoescape=select_autoescape(["html", "htm", "xml"]))

# Jinja's dangerous switches: the |safe filter, Markup(text) in Python,
# and {% autoescape false %} blocks.

ما الذي لا يمكن للهروب التلقائي القيام به حتى الآن

  • السمات غير المقتبسة: <div title={{ x }}> تنكسر بفراغ واحد. اكتب دائما title="{{ x }}".
  • عناوين الروابط: href="{{ url }}" تم الهروب منه، ولكن عنوان javascript: ليس لديه ما يتم الهروب منه. تحقق من أن الروابط تبدأ بـ https:// أو http:// قبل تخزينها أو عرضها.
  • داخل كتل <script>: استخدم سمات json_script أو data- بدلا من فجوات القالب.

عادة لمراجعة الكود

ابحث في مشروعك عن |safe و mark_safe و autoescape off و Markup(، وفي كود الواجهة الأمامية، ابحث عن innerHTML و dangerouslySetInnerHTML. يجب أن يكون لكل نتيجة سبب في سطر واحد بجانبها. إذا كانت القيمة يمكن أن تحتوي على نص من الزائر، فهي خطأ برمجي ينتظر الحدوث.

A مفهوم خاطئ شائع

"إطار عملنا يقوم بعملية escape، لذا لا يمكننا التعرض لـ XSS." إطارات العمل تقوم بعملية escape لـ gaps. لا يمكنها حماية قيمة قمت بتحديدها كآمنة، أو عنوان لم تقم بفحصه، أو كود front-end يستخدم innerHTML. تضيف الوحدة التالية طبقة ثانية، وهي Content Security Policy، للأخطاء التي لا تزال تتسلل.

هل تريد التعمق أكثر؟ توفر Web Security Academy المجانية من PortSwigger مساراً كاملاً لـ XSS مع مختبرات تدريب خاصة بها، تم بناؤها للتعلم بأمان.

في لغات أخرى

نفس الإعدادات الافتراضية، ونفس المفاتيح الخطيرة، في المكدسات الأخرى:

// React: text in JSX is escaped for you
<p>{review.text}</p>
// the switch that turns it off (the name is a warning on purpose)
<div dangerouslySetInnerHTML={{ __html: review.text }} />

// Go: html/template escapes for the context (text, attribute, URL, script)
import "html/template"           // escapes
// import "text/template"        // does NOT escape: never use it for HTML
tmpl := template.Must(template.New("p").Parse(`<p>{{.}}</p>`))
// the switch: template.HTML(text) marks text as already safe

// PHP (Twig) auto-escapes; {{ text|raw }} turns it off
// C# (Razor) auto-escapes @text; @Html.Raw(text) turns it off

ملخص

  • يقوم Django بعملية escape لكل قيمة في القالب بشكل افتراضي؛ أما Jinja فيقوم بذلك فقط عندما تقوم بتفعيله.
  • المفاتيح الخطيرة: |safe، mark_safe، autoescape off، Markup، dangerouslySetInnerHTML، و template.HTML الخاصة بـ Go.
  • استخدم format_html لبناء HTML في Python و json_script لتمرير البيانات إلى JavaScript.
  • لا يتحقق Escaping من عناوين الروابط أو يصلح السمات غير المقتبسة: قم باقتباسها واسمح فقط بروابط http و https.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.