Cookie-gebruik configureren configuring-cookie-usage
AEM verstrekt de dienst die u toelaat om te vormen en te controleren hoe de koekjes met uw Web-pagina's worden gebruikt:
- Een configureerbare server-zijdienst handhaaft een lijst van koekjes die kunnen worden gebruikt.
- Met een JavaScript API kan uw JavaScript-code controleren of een cookie kan worden gebruikt.
Gebruik deze functie om ervoor te zorgen dat uw pagina's voldoen aan de toestemming van uw gebruikers met betrekking tot het gebruik van cookies.
Toegestane cookies configureren configuring-allowed-cookies
Configureer de Adobe Granite Opt-Out Service om op te geven hoe cookies op uw webpagina's worden gebruikt. In de volgende tabel worden de eigenschappen beschreven die u kunt configureren.
Om de dienst te vormen, kunt u de Console van het Webgebruiken of een configuratie OSGi aan de bewaarplaatstoevoegen. In de volgende tabel worden de eigenschappen beschreven die u voor een van beide methoden nodig hebt. Voor een configuratie OSGi, is de dienst PID com.adobe.granite.optout
.
Cookiegebruik valideren validating-cookie-usage
Gebruik client-side JavaScript om de Adobe Granite Opt-Out Service te bellen om te controleren of u een cookie kunt gebruiken. Met het JavaScript-object Granite.OptOutUtil kunt u een van de volgende taken uitvoeren:
- Vraag een lijst met cookienamen aan die aangeven dat de gebruiker geen toestemming geeft cookies te gebruiken voor traceringsdoeleinden.
- Verkrijg een lijst van koekjes die kunnen worden gebruikt.
- Bepaal of de webbrowser een cookie bevat die aangeeft dat de gebruiker geen toestemming geeft voor het gebruik van cookies voor tracering.
- Bepaal of een specifieke cookie kan worden gebruikt.
granite.utils omslag van de cliëntbibliotheekverstrekt het voorwerp Granite.OptOutUtil. Voeg de volgende code toe aan de paginakop JSP om een koppeling naar de JavaScript-bibliotheek op te nemen:
<ui:includeClientLib categories="granite.utils" />
De volgende JavaScript-functie bepaalt bijvoorbeeld of het cookie COOKIE_NAME is toegestaan voor gebruik voordat ernaar wordt geschreven:
function writeCookie(value){
if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
return;
if (value) {
value = encodeURIComponent(value);
document.cookie = "COOKIE_NAME=" + value;
}
}
Het JavaScript-object Granite.OptOutUtil the-granite-optoututil-javascript-object
Granite.OptOutUtil laat u toe om te bepalen of het koekjesgebruik wordt toegestaan.
getCookieNames() functie getcookienames-function
De namen van de cookies die, indien aanwezig, aangeven dat de gebruiker geen toestemming heeft gegeven voor het gebruik van cookies.
Parameters
Geen.
Keert terug
Een array van cookie namen.
getWhitelistCookieNames() functie getwhitelistcookienames-function
De namen van cookies die kunnen worden gebruikt, ongeacht de toestemming van de gebruiker.
Parameters
Geen.
Keert terug
Een array van cookie namen.
isOptedOut() functie isoptedout-function
Hiermee wordt bepaald of de browser van de gebruiker cookies bevat die aangeven dat geen toestemming is gegeven om cookies te gebruiken.
Parameters
Geen.
Keert terug
Een Booleaanse waarde: true
als een cookie wordt gevonden die geen toestemming aangeeft, en de waarde false
als er geen cookies zijn die aangeven dat er geen toestemming is.
maySetCookie(cookieName), functie maysetcookie-cookiename-function
Hiermee wordt bepaald of een specifieke cookie in de browser van de gebruiker kan worden gebruikt. Deze functie is gelijk aan het gebruik van de functie isOptedOut
om te bepalen of het opgegeven cookie is opgenomen in de lijst die de functie getWhitelistCookieNames
retourneert.
Parameters
- cookieName: String. De naam van het cookie.
Keert terug
Een Booleaanse waarde: true
if cookieName
kan worden gebruikt, of de waarde false
if cookieName
kan niet worden gebruikt.