قالبهایی که بهطور پیشفرض گریز میزنند
چرا مهم است بهندرت HTML را با دست به هم میچسبانید. سایتهای واقعی از قالب استفاده میکنند و سیستمهای قالب خوب هر مقداری را برایتان گریز میزنند. کار شما بیشتر این است که آن را تصادفاً خاموش نکنید و چند کلیدی را که خاموشش میکنند بشناسید.
یک تمثیل: ماشینی که برایتان ترمز میگیرد
ماشینهای امروزی اگر نزدیک برخورد با چیزی باشید خودکار ترمز میگیرند. میتوانید این قابلیت را خاموش کنید و گاهی دلیل خوبی هم هست. اما هر بار که خاموش است، ارزش دارد بپرسید چرا. گریز خودکار هم همینطور است: در ابزارهای خوب بهطور پیشفرض روشن است و چند راه با نام روشن برای خاموش کردنش وجود دارد.
قالب: یک فایل HTML با جاهای خالی، مثل {{ name }}، که سرور برای هر صفحه پرشان میکند. موتور قالب کدی است که جاهای خالی را پر میکند.
گریز خودکار: موتور قالب هر مقداری را که در یک جای خالی میگذارد گریز میزند، مگر اینکه به آن بگویید مقدار از قبل امن است.
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 %}در کد پایتون، mark_safe(text) به Django میگوید «این از قبل HTML است، گریزش نزن». فقط روی متنی که کد خودتان نوشته از آن استفاده کنید. وقتی لازم است یک تکهٔ کوچک HTML را در پایتون بسازید، از format_html استفاده کنید که هر مقداری را که به آن بدهید گریز میزند:
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برای فرستادن داده به جاوااسکریپت صفحهتان، به جای چسباندن مقدارها در یک بلوک <script> از فیلتر json_script استفاده کنید. داده را طوری بهصورت JSON مینویسد که نمیتواند برچسب اسکریپت را زودتر از موعد ببندد.
Jinja (و Flask)
Jinja موتور قالب پرطرفدار دیگری برای پایتون است. پیشفرض آن متفاوت است: یک Environment() ساده گریز نمیزند. آن را روشن کنید، همانطور که Flask برای قالبهای .html میکند:
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 جستوجو کنید. کنار هر مورد یافتشده باید دلیلی یکخطی باشد. اگر مقدار ممکن است روزی متن بازدیدکننده داشته باشد، اشکالی است که منتظر رخ دادن است.
یک تصور نادرست رایج
«چارچوب ما گریز میزند، پس نمیتوانیم XSS داشته باشیم.» چارچوبها جاهای خالی را گریز میزنند. نمیتوانند از مقداری که امن علامت زدهاید، نشانیای که بررسی نکردهاید، یا کد سمت کاربری که از innerHTML استفاده میکند محافظت کنند. ماژول بعدی لایهٔ دومی، سیاست امنیت محتوا، برای اشتباههایی که هنوز رد میشوند اضافه میکند.
میخواهید عمیقتر شوید؟ 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 بهطور پیشفرض هر مقدار قالب را گریز میزند؛ Jinja فقط وقتی روشنش کنید.
- کلیدهای خطرناک:
|safe،mark_safe،autoescape off،Markup،dangerouslySetInnerHTML، وtemplate.HTMLدر Go. - برای ساختن HTML در پایتون از
format_htmlو برای دادن داده به جاوااسکریپت ازjson_scriptاستفاده کنید. - گریز زدن نشانی پیوندها را بررسی نمیکند یا ویژگیهای بیگیومه را درست نمیکند: دورشان گیومه بگذارید و فقط پیوندهای http و https را مجاز کنید.
مشکلی در این درس دیدید؟ گزارشش کنید · دربارهٔ این درس بپرسید
این تمرین بهزودی باز میشود
درس پیش از آن را تمام کنید تا این یکی باز شود. کل دوره رایگان است، حساب کاربری لازم نیست، و میتوانید همین الان این درس را بخوانید.
این مرورگر کوکیهای learn.floati.life را مسدود میکند، پس درسهایی که اینجا تمام کردید نمیتوانند به ترتیب باز شوند. کوکیها را برای این سایت مجاز کنید و صفحه را دوباره بارگذاری کنید.