Temario Lección 63 de 156 · Inyección de scripts (XSS)
Inyección de scripts (XSS)

Plantillas que escapan por defecto

Por qué importa Rara vez pegarás trozos de HTML a mano. Los sitios reales usan plantillas, y los buenos sistemas de plantillas escapan cada valor por ti. Tu trabajo consiste sobre todo en no desactivar eso sin querer, y en reconocer los pocos interruptores que lo hacen.

Una analogía: un coche que frena por ti

Los coches modernos frenan automáticamente si estás a punto de chocar con algo. Puedes desactivar la función, y a veces hay un buen motivo. Pero cada vez que está desactivada, merece la pena preguntarse por qué. El escapado automático es igual: activado por defecto en las buenas herramientas, con unas pocas formas, con nombres claros, de desactivarlo.

Plantilla: un archivo HTML con huecos, como {{ name }}, que el servidor rellena para cada página. El motor de plantillas es el código que rellena los huecos.

Escapado automático: el motor de plantillas escapa cada valor que mete en un hueco, a menos que le digas que el valor ya es seguro.

Django

Las plantillas de Django escapan por defecto cada {{ value }}: <, >, &, " y ', los mismos cinco que escapaste a mano. Las páginas de los cursos de este sitio están hechas así.

{# 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 %}

En el código Python, mark_safe(text) le dice a Django "esto ya es HTML, no lo escapes". Úsalo solo con texto que haya escrito tu propio código. Cuando necesites construir un trocito de HTML en Python, usa format_html, que escapa cada valor que le pasas:

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

Para pasar datos al JavaScript de tu página, usa el filtro json_script en lugar de pegar valores dentro de un bloque <script>. Escribe los datos como JSON de una forma que no puede cerrar antes de tiempo la etiqueta del script.

Jinja (y Flask)

Jinja es otro motor de plantillas popular de Python. Su valor por defecto es distinto: un Environment() normal no escapa. Actívalo, como hace Flask con las plantillas .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.

Lo que el escapado automático todavía no puede hacer

  • Atributos sin comillas: <div title={{ x }}> se rompe con un solo espacio. Escribe siempre title="{{ x }}".
  • Direcciones de enlaces: href="{{ url }}" se escapa, pero una dirección javascript: no tiene nada que escapar. Comprueba que los enlaces empiezan por https:// o http:// antes de guardarlos o mostrarlos.
  • Dentro de los bloques <script>: usa json_script o atributos data- en lugar de huecos de plantilla.

Un hábito para la revisión de código

Busca en tu proyecto |safe, mark_safe, autoescape off, Markup( y, en el código del navegador, innerHTML y dangerouslySetInnerHTML. Cada resultado debería tener al lado una línea con el motivo. Si el valor pudiera contener alguna vez texto de un visitante, es un fallo esperando a ocurrir.

Una idea equivocada muy común

"Nuestro framework escapa, así que no podemos tener XSS." Los frameworks escapan los huecos. No pueden proteger un valor que marcaste como seguro, una dirección que no comprobaste ni un código del navegador que usa innerHTML. El próximo módulo añade una segunda capa, la Content Security Policy, para los errores que aún se cuelan.

¿Quieres profundizar? La Web Security Academy gratuita de PortSwigger tiene un itinerario completo sobre XSS con sus propios laboratorios de práctica, pensados para aprender de forma segura.

En otros lenguajes

Los mismos valores por defecto, y los mismos interruptores peligrosos, en otros entornos:

// 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

Resumen

  • Django escapa por defecto cada valor de una plantilla; Jinja solo cuando lo activas.
  • Los interruptores peligrosos: |safe, mark_safe, autoescape off, Markup, dangerouslySetInnerHTML, el template.HTML de Go.
  • Usa format_html para construir HTML en Python y json_script para pasar datos a JavaScript.
  • El escapado no comprueba las direcciones de los enlaces ni arregla los atributos sin comillas: ponles comillas y permite solo los enlaces http y https.

¿Has visto un problema en esta lección? Avísanos · Preguntar sobre esta lección

Este ejercicio se abre pronto

Termina la lección anterior y esta se desbloquea. Todo el curso es gratis, no hace falta cuenta, y puedes leer esta lección ahora mismo.