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

CKTIS / HTML

referrerpolicy — nadzor podatkov o napotitelju

Atribut referrerpolicy določa, koliko podatkov o naslovu napotitvene strani sme brskalnik poslati v glavi Referer med navigacijo ali pridobivanjem vira. Velja za določen element; ni globalni atribut niti nastavitev CORS.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

referrerpolicy="no-referrer|no-referrer-when-downgrade|origin|origin-when-cross-origin|same-origin|strict-origin|strict-origin-when-cross-origin|unsafe-url"

referrerpolicy je našteti atribut elementov a, area, img, iframe, script in link. Nadzira podatke, poslane v glavi HTTP Referer — ime glave namenoma ohranja zgodovinski zapis. Pri a in area velja za navigacijo, pri img za pridobivanje slike, pri iframe za navigacijo okvirja, pri link pa za pridobivanje in obdelavo zunanjega vira.

Vrednosti: no-referrer izpusti glavo; same-origin pošlje naslov samo istemu izvoru; origin pošlje samo izvor; origin-when-cross-origin pošlje naslov znotraj istega izvora, drugje pa samo izvor. Izvor sestavljajo shema, gostitelj in vrata; ne pomeni preprosto iste domene. »Naslov« tukaj pomeni URL brez fragmenta in poverilnic za prijavo, lahko pa še vedno vključuje pot in parametre poizvedbe.

no-referrer-when-downgrade pošlje naslov, razen pri prehodu iz varnega v manj varen kontekst, na primer HTTPS → HTTP. strict-origin pošlje samo izvor in ga pri takem poslabšanju varnosti izpusti. strict-origin-when-cross-origin pošlje naslov znotraj istega izvora, med izvori samo izvor, pri takem poslabšanju pa ničesar. unsafe-url pošlje naslov tudi pri poslabšanju varnosti: razkrije lahko občutljive poti in parametre poizvedbe.

Manjkajoč atribut, prazen niz in neprepoznana vrednost pomenijo prazno stanje pravilnika, ne no-referrer; uporabi se pravilnik, ki ga določa kontekst dokumenta. rel="noreferrer" ima prednost pred pravilnikom hiperpovezave. Pri script nastavitev zajema začetni prenos in uvoze modulov, vključno z import(), ne pa običajnih klicev fetch() v njegovi kodi. Atribut ne podeljuje dovoljenj CORS in ne onemogoča piškotkov.

Primeri

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Per-link referrer policy</title>
</head>
<body>
  <p><a id="private-link" href="#destination" referrerpolicy="no-referrer">Destination with no referrer</a></p>
  <p><a id="default-link" href="#destination">Destination without a policy override</a></p>
  <p id="destination">Destination</p>
  <script>
    const privateLink = document.getElementById('private-link');
    const defaultLink = document.getElementById('default-link');
    for (const link of [privateLink, defaultLink]) {
      for (const type of ['click', 'auxclick']) {
        link.addEventListener(type, event => event.preventDefault());
      }
    }
    console.log('Explicit link policy: ' + privateLink.referrerPolicy);
    console.log('Other link policy override: ' + JSON.stringify(defaultLink.referrerPolicy));
  </script>
</body>
</html>

Rezultat

Explicit link policy: no-referrer
Other link policy override: ""

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

Viri