Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / JavaScript

Varnostne meje: ubežanje besedila HTML in sanitizacija

Varnostna meja ločuje nezaupanja vredne podatke od operacij, ki jim pripišejo pomen ali pooblastila. Spoznajte razliko med ubežanjem besedila HTML in sanitizacijo z dovoljenim seznamom ter omejitve kratkega primera ubežanja v JavaScriptu.

Različica: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaksa

escapeHtmlText(value); // HTML text context only; not an HTML sanitizer

Varnostna meja (security boundaries) je točka, kjer podatki z nižjo stopnjo zaupanja dosežejo operacijo, ki jih lahko razume kot kodo ali označevanje. Vhod ne postane zaupanja vreden zgolj zato, ker je niz JavaScript. ECMAScript določa jezik, razčlenjevanje HTML in zaščita brskalnika pa sodita v gostiteljsko okolje; podana specifikacija ni standard za sanitizacijo HTML.

Ubežanje besedila HTML in sanitizacija z dovoljenim seznamom: ubežanje zamenja posebne znake z znakovnimi referencami, da se vsebina obravnava kot besedilo, ne kot označevanje. Sanitizacija ima drug namen: dovoli izbrane oznake, nedovoljene elemente, atribute in nevarne vrednosti URL pa odstrani ali zavrne. Sanitizatorja ne nadomestite s preprostim regularnim izrazom, ki odstranjuje oznake.

Funkcija escapeHtmlText sprejme niz in v enem prehodu ubeži &, < in >. Namenjena je izključno običajnemu besedilnemu kontekstu HTML, ne atributom, URL-jem, JavaScriptu, CSS-u ali vsebini elementov script in style. Narekovaji namerno ostanejo nespremenjeni. Rezultat ni »varen HTML« za poljubno uporabo; ponovno ubežanje že ubežanega rezultata ga znova spremeni.

Primer preverja samo deterministično pretvorbo niza in ne potrebuje API-ja brskalnika. Ne prikazuje izrisovanja in ne preverja sanitizatorja. Aplikacija, ki mora ohraniti oblikovanje HTML, potrebuje ločeno izbrano in preverjeno politiko sanitizacije. Izvajanje kode v Node.js ne dokazuje razpoložljivosti ali varnosti API-ja brskalnika.

Primeri

function escapeHtmlText(value) {
  const entities = { "&": "&amp;", "<": "&lt;", ">": "&gt;" };
  return value.replace(/[&<>]/g, character => entities[character]);
}

const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"';
if (actual !== expected) {
  throw new Error("Unexpected escaping result");
}
console.log(actual);

Rezultat

&lt;b&gt;Hello&lt;/b&gt; &amp; "friends"

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri