Konfigurerar cookie-användning

AEM tillhandahåller en tjänst som gör att du kan konfigurera och styra hur cookies används med dina webbsidor:

  • En konfigurerbar tjänst på serversidan upprätthåller en lista över cookies som kan användas.
  • Med ett JavaScript-API kan JavaScript-koden verifiera att en cookie kan användas.

Använd den här funktionen för att kontrollera att sidorna uppfyller användarnas samtycke när det gäller användningen av cookies.

Konfigurera tillåtna cookies

Konfigurera avanmälningstjänsten för Adobe Granite för att ange hur cookies ska användas på dina webbsidor. I följande tabell beskrivs de egenskaper som du kan konfigurera.

Om du vill konfigurera tjänsten kan du använda Webbkonsol eller lägga till en OSGi-konfiguration i databasen. I följande tabell beskrivs de egenskaper som du behöver för båda metoderna. Tjänstens-PID är för en OSGi-konfiguration com.adobe.granite.optout.

Egenskapsnamn (webbkonsol) OSGi-egenskapsnamn Beskrivning
Cookies för avanmälan optout.cookies Namnen på cookies som anger, när de finns på användarens enhet, att användaren inte har samtyckt till att använda cookies.
Avanmäl HTTP-huvuden optout.headers Namnen på HTTP-rubriker som anger, i förekommande fall, att användaren inte har samtyckt till att använda cookies.
Cookies i vitlista optout.whitelist.cookies En lista över cookies som är viktiga för att webbplatsen ska fungera och som kan användas utan användarens samtycke.

Använd JavaScript på klientsidan för att anropa Adobe Granite-avanmälningstjänsten för att verifiera att du kan använda en cookie. Använd Granite.OptOutUtil JavaScript-objektet om du vill utföra någon av följande åtgärder:

  • Hämta en lista med cookie-namn som anger att användaren inte godkänner att cookies används i spårningssyfte.
  • Hämta en lista med cookies som kan användas.
  • Avgör om webbläsaren innehåller en cookie som anger att användaren inte godkänner användningen av cookies för spårning.
  • Avgör om en viss cookie kan användas.

The granite.utils klientbiblioteksmapp innehåller objektet Granite.OptOutUtil. Lägg till följande kod i sidhuvud-JSP för att inkludera en länk till JavaScript-biblioteket:

<ui:includeClientLib categories="granite.utils" />

Följande JavaScript-funktion avgör till exempel om cookie-filen COOKIE_NAME får användas innan den skrivs till den:

function writeCookie(value){
   if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
      return;
   if (value) {
      value = encodeURIComponent(value);
      document.cookie = "COOKIE_NAME=" + value;
   }
}

JavaScript-objektet Granite.OptOutUtil

Granite.OptOutUtil gör att du kan avgöra om cookie-användning är tillåten.

funktionen getCookieNames()

Namnen på de cookies som, i förekommande fall, anger att användaren inte har gett sitt samtycke till användningen av cookies.

Parametrar

Ingen.

Returnerar

En array med cookie-namn.

funktionen getWhitelistCookieNames()

Namnen på cookies som kan användas oavsett användarens samtycke.

Parametrar

Ingen.

Returnerar

En array med cookie-namn.

funktionen isOptedOut()

Avgör om användarens webbläsare innehåller cookies som anger att samtycke inte har getts för att använda cookies.

Parametrar

Ingen.

Returnerar

Ett booleskt värde på true om det finns en cookie som inte anger något samtycke och värdet false om inga cookies tyder på icke-samtycke.

Funktionen maySetCookie(cookieName)

Avgör om en viss cookie kan användas i användarens webbläsare. Den här funktionen motsvarar att använda isOptedOut funktionen för att avgöra om den angivna cookien finns med i listan som getWhitelistCookieNames funktionen returnerar.

Parametrar

  • cookieName: String. Namnet på kakan.

Returnerar

Ett booleskt värde på true if cookieName kan användas, eller ett värde på false if cookieName kan inte användas.

På denna sida