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 Webbkonsol eller lägga till en OSGi-konfiguration i databasen. I följande tabell beskrivs de egenskaper som du behöver för någon av metoderna. Tjänstens-PID är för en OSGi-konfiguration com.adobe.granite.optout.
Verifierar cookie-användning validating-cookie-usage
Använd javascript på klientsidan för att anropa tjänsten Adobe Granite Opt-Out 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 biblioteksmapp för klient 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 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;
}
}
Objektet Granite.OptOutUtil JavaScript the-granite-optoututil-javascript-object
Med Granite.OptOutUtil kan du avgöra om cookie-användning är tillåten.
funktionen getCookieNames() getcookienames-function
Returnerar 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
Returnerar 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 det finns en cookie som inte anger något samtycke och värdet false om inga cookies tyder på 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 isOptedOut funktionen tillsammans med att fastställa om den angivna cookien finns med i listan som getWhitelistCookieNames funktionen returnerar.
Parametrar
- cookieName: Sträng. 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.