Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / JavaScript

Granice bezpieczeństwa: tekst HTML a sanityzacja

Granica bezpieczeństwa oddziela niezaufane dane od operacji nadających im znaczenie lub uprawnienia. Poznaj różnicę między kodowaniem tekstu HTML a sanityzacją opartą na liście dozwolonych elementów oraz ograniczenia prostego przykładu w JavaScript.

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

Składnia

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

Granica bezpieczeństwa (security boundaries) to miejsce, w którym dane o niższym poziomie zaufania trafiają do operacji mogącej interpretować je jako kod lub znaczniki. Tekst wejściowy nie staje się zaufany tylko dlatego, że jest ciągiem znaków JavaScript. ECMAScript definiuje język, natomiast parsowanie HTML i zabezpieczenia przeglądarki należą do środowiska hosta; podana specyfikacja nie jest standardem sanityzacji HTML.

Kodowanie tekstu HTML a sanityzacja oparta na liście dozwolonych elementów (HTML text escaping versus allowlist sanitization): kodowanie zastępuje znaki specjalne odwołaniami do znaków, aby treść była traktowana jako tekst, a nie znaczniki. Sanityzacja służy innemu celowi: dopuszcza wybrane znaczniki, usuwając lub odrzucając niedozwolone elementy, atrybuty i niebezpieczne wartości URL. Nie zastępuj sanityzatora prostym wyrażeniem regularnym usuwającym znaczniki.

Funkcja escapeHtmlText przyjmuje ciąg znaków i koduje &, < oraz > w jednym przebiegu. Jej zakres to wyłącznie zwykły kontekst tekstowy HTML, nie atrybuty, adresy URL, kod JavaScript, CSS ani zawartość elementów script i style. Cudzysłowy pozostają bez zmian celowo. Wynik nie jest „bezpiecznym HTML” do dowolnego użycia; ponowne kodowanie zakodowanego wyniku zmieni go jeszcze raz.

Przykład sprawdza wyłącznie deterministyczną transformację ciągu znaków i nie wymaga API przeglądarki. Nie demonstruje renderowania ani nie weryfikuje sanityzatora. Gdy aplikacja ma zachować formatowanie HTML, potrzebuje osobno dobranej i zweryfikowanej polityki sanityzacji. Uruchomienie kodu w Node.js nie potwierdza dostępności ani bezpieczeństwa API przeglądarki.

Przykłady

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);

Wynik

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

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła