Template yang otomatis ter-escape
Kenapa ini penting Kamu jarang sekali akan menggabungkan HTML secara manual. Situs asli menggunakan template, dan sistem template yang bagus akan melakukan escape pada setiap nilai untukmu. Tugasmu sebagian besar adalah jangan mematikan itu secara tidak sengaja, dan mengenali beberapa switch yang memang mematikannya.
Analogi: mobil yang mengerem untukmu
Mobil modern mengerem otomatis kalau kamu hampir menabrak sesuatu. Kamu bisa mematikan fitur itu, dan terkadang ada alasan yang bagus. Tapi setiap kali fitur itu mati, ada baiknya bertanya kenapa. Auto-escaping juga sama: aktif secara default di alat yang bagus, dengan beberapa cara yang diberi nama jelas untuk mematikannya.
Template: file HTML dengan celah, seperti {{ name }}, yang diisi oleh server untuk setiap halaman. template engine adalah kode yang mengisi celah tersebut.
Auto-escaping: mesin template akan melakukan escape pada setiap nilai yang dimasukkan ke dalam celah, kecuali kamu memberi tahu bahwa nilai tersebut sudah aman.
Django
Django templates melakukan escape pada setiap {{ value }} secara default: <, >, &, " dan ', lima hal yang sama yang kamu escape secara manual. Halaman kursus situs ini dibangun dengan cara itu.
{# 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 %}Dalam kode Python, mark_safe(text) memberi tahu Django "ini sudah HTML, jangan di-escape". Gunakan hanya pada teks yang ditulis oleh kodemu sendiri. Saat kamu perlu membuat potongan kecil HTML di Python, gunakan format_html, yang akan meng-escape setiap nilai yang kamu masukkan:
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 escapedUntuk mengirim data ke JavaScript halamanmu, gunakan filter json_script daripada menempelkan nilai ke dalam blok <script>. Ini menulis data sebagai JSON dengan cara yang tidak bisa menutup tag script lebih awal.
Jinja (dan Flask)
Jinja adalah engine template Python populer lainnya. Defaultnya berbeda: Environment() biasa tidak melakukan not escape. Aktifkan itu, seperti yang dilakukan Flask untuk .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.Apa yang masih belum bisa dilakukan oleh auto-escaping
- Atribut tanpa tanda kutip:
<div title={{ x }}>terputus dengan satu spasi. Selalu tulistitle="{{ x }}". - Alamat link:
href="{{ url }}"sudah di-escape, tapi alamatjavascript:tidak ada yang perlu di-escape. Pastikan link dimulai denganhttps://atauhttp://sebelum kamu simpan atau tampilkan. - Di dalam blok
<script>: gunakan atributjson_scriptataudata-sebagai pengganti celah template.
Kebiasaan untuk code review
Cari proyek kamu untuk |safe, mark_safe, autoescape off, Markup( dan, di kode front-end, innerHTML dan dangerouslySetInnerHTML. Setiap temuan harus punya alasan satu baris di sampingnya. Jika nilainya bisa berisi teks pengunjung, itu adalah bug yang akan terjadi.
Kesalahpahaman umum
"Framework kita melakukan escape, jadi kita tidak bisa kena XSS." Framework melakukan escape pada gaps. Mereka tidak bisa melindungi nilai yang kamu tandai aman, alamat yang tidak kamu cek, atau kode front-end yang menggunakan innerHTML. Modul berikutnya menambah lapisan kedua, Content Security Policy, untuk kesalahan yang masih lolos.
Mau belajar lebih dalam? PortSwigger's free Web Security Academy punya track XSS lengkap dengan lab latihan sendiri, dibuat untuk belajar dengan aman.
Di bahasa lain
Default yang sama, dan switch berbahaya yang sama, di stack lain:
// 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 offRingkasan
- Django melakukan escape pada setiap nilai template secara default; Jinja hanya jika kamu mengaktifkannya.
- Saklar yang berbahaya:
|safe,mark_safe,autoescape off,Markup,dangerouslySetInnerHTML,template.HTMLmilik Go. - Gunakan
format_htmluntuk membangun HTML di Python danjson_scriptuntuk memberikan data ke JavaScript. - Escaping tidak memeriksa alamat link atau memperbaiki atribut tanpa tanda kutip: beri tanda kutip dan izinkan hanya link http dan https.
Ada masalah di pelajaran ini? Laporkan · Tanya tentang pelajaran ini
Latihan ini akan segera dibuka
Selesaikan pelajaran sebelumnya agar pelajaran ini terbuka. Seluruh kursus ini gratis, tidak butuh akun, dan kamu bisa baca pelajaran ini sekarang.
Browser ini memblokir cookie untuk learn.floati.life, jadi pelajaran yang sudah kamu selesaikan di sini tidak bisa dibuka berurutan. Izinkan cookie untuk situs ini dan muat ulang.