Cookie-gebruik configureren

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

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 Webconsole of een configuratie OSGi aan bewaarplaats toevoegen. 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.

Koekjesgebruik valideren

Gebruik client-side javascript om Adobe Granite Opt-Out Service aan te roepen om te controleren of u een cookie kunt gebruiken. Gebruik het JavaScript-object Granite.OptOutUtil om een van de volgende taken uit te voeren:

• Vraag een lijst met cookies 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 de omslag van de cliëntbibliotheek verstrekt het voorwerp Granite.OptOutUtil. Voeg de volgende code aan uw paginakop JSP toe om een verbinding aan de bibliotheek te omvatten javascript:

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

De volgende javascript-functie bepaalt bijvoorbeeld of het cookie COOKIE_NAME mag worden gebruikt 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

Granite.OptOutUtil laat u toe om te bepalen of het koekjesgebruik wordt toegestaan.

getCookieNames() functie

Geeft de namen van de cookies weer die, indien aanwezig, aangeven dat de gebruiker geen toestemming heeft gegeven voor het gebruik van cookies.

Parameters

Geen.

Geeft als resultaat

Een array van cookie namen.

getWhitelistCookieNames() functie

Retourneert de namen van cookies die kunnen worden gebruikt, ongeacht de toestemming van de gebruiker.

Parameters

Geen.

Geeft als resultaat

Een array van cookie namen.

isOptedOut() functie

Hiermee wordt bepaald of de browser van de gebruiker cookies bevat die aangeven dat geen toestemming is gegeven om cookies te gebruiken.

Parameters

Geen.

Geeft als resultaat

Een booleaanse waarde van true als een cookie wordt gevonden die geen toestemming aangeeft, en een waarde van false als geen cookies aangeven dat geen toestemming is gegeven.

maySetCookie(cookieName) functie

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 in combinatie met het bepalen of het opgegeven cookie is opgenomen in de lijst die de functie getWhitelistCookieNames retourneert.

Parameters

• cookieName: Tekenreeks. De naam van het cookie.

Geeft als resultaat

Een booleaanse waarde van true als cookieName kan worden gebruikt, of een waarde van false als cookieName niet kan worden gebruikt.