Konfigurerar cookie-användning configuring-cookie-usage
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 din JavaScript-kod 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 configuring-allowed-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 webbkonsolen 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 com.adobe.granite.optout
för en OSGi-konfiguration.
Verifierar cookie-användning validating-cookie-usage
Använd JavaScript på klientsidan för att ringa Adobe Granite-avanmälningstjänsten för att verifiera att du kan använda en cookie. Använd Granite.OptOutUtil JavaScript-objektet för att 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.
Klientbiblioteksmappen granite.utilsinnehå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 cookien 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 the-granite-optoututil-javascript-object
Granite.OptOutUtil gör att du kan avgöra om cookie-användning är tillåten.
funktionen getCookieNames() getcookienames-function
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() getwhitelistcookienames-function
Namnen på cookies som kan användas oavsett användarens samtycke.
Parametrar
Ingen.
Returnerar
En array med cookie-namn.
funktionen isOptedOut() isoptedout-function
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 en cookie påträffas som inte anger något samtycke, och värdet false
om inga cookies indikerar icke-samtycke.
Funktionen maySetCookie(cookieName) maysetcookie-cookiename-function
Avgör om en viss cookie kan användas i användarens webbläsare. Den här funktionen motsvarar att använda funktionen isOptedOut
för att avgöra om den angivna cookien finns med i listan som funktionen getWhitelistCookieNames
returnerar.
Parametrar
- cookieName: String. Namnet på kakan.
Returnerar
Ett booleskt värde på true
om cookieName
kan användas, eller värdet false
om cookieName
inte kan användas.