CKTIS / JavaScript
Bezpečnostné hranice: escapovanie textu HTML a sanitizácia
Bezpečnostná hranica oddeľuje nedôveryhodné údaje od operácií, ktoré im dávajú význam alebo oprávnenie. Spoznajte rozdiel medzi escapovaním textu HTML a sanitizáciou pomocou zoznamu povolených prvkov aj obmedzenia malého príkladu escapovania v JavaScripte.
Verzia: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
escapeHtmlText(value); // HTML text context only; not an HTML sanitizerBezpečnostná hranica (security boundaries) je miesto, kde sa údaje s nižšou mierou dôvery dostanú k operácii, ktorá ich môže interpretovať ako kód alebo značky. Vstup sa nestáva dôveryhodným len preto, že ide o reťazec JavaScriptu. ECMAScript definuje jazyk, zatiaľ čo parsovanie HTML a ochrana prehliadača patria do hostiteľského prostredia; dodaná špecifikácia nie je štandardom sanitizácie HTML.
Escapovanie textu HTML oproti sanitizácii pomocou zoznamu povolených prvkov: pri escapovaní sa špeciálne znaky nahrádzajú znakovými referenciami, aby sa obsah spracoval ako text, nie ako značky. Sanitizácia má iný účel: povoľuje vybrané značky a odstraňuje alebo odmieta nepovolené prvky, atribúty a nebezpečné hodnoty URL. Nenahrádzajte sanitizátor jednoduchým regulárnym výrazom, ktorý odstraňuje značky.
Funkcia escapeHtmlText prijíma reťazec a v jednom priechode escapuje &, < a >. Je určená výhradne pre bežný textový kontext HTML, nie pre atribúty, URL, JavaScript, CSS ani obsah prvkov script a style. Úvodzovky zámerne ponecháva bez zmeny. Výsledkom nie je „bezpečné HTML“ na ľubovoľné použitie; opätovné escapovanie už escapovaného výsledku ho znovu zmení.
Príklad overuje iba deterministickú transformáciu reťazca a nevyžaduje API prehliadača. Neznázorňuje vykresľovanie ani neoveruje sanitizátor. Aplikácia, ktorá potrebuje zachovať formátovanie HTML, potrebuje samostatne zvolenú a overenú zásadu sanitizácie. Spustenie kódu v Node.js nedokazuje dostupnosť ani bezpečnosť API prehliadača.
Príklady
function escapeHtmlText(value) {
const entities = { "&": "&", "<": "<", ">": ">" };
return value.replace(/[&<>]/g, character => entities[character]);
}
const input = '<b>Hello</b> & "friends"';
const actual = escapeHtmlText(input);
const expected = '<b>Hello</b> & "friends"';
if (actual !== expected) {
throw new Error("Unexpected escaping result");
}
console.log(actual);Výsledok
<b>Hello</b> & "friends"
Zobrazený kód a uvedený výsledok boli overené v izolovanom prostredí metódou zaznamenanou v dôkaze o overení tejto presnej verzie.