Configurazione dell’utilizzo dei cookie

AEM fornisce un servizio che consente di configurare e controllare il modo in cui i cookie vengono utilizzati con le pagine web:

  • Un servizio lato server configurabile mantiene un elenco di cookie che possono essere utilizzati.
  • Un’API JavaScript consente al codice JavaScript di verificare che sia possibile utilizzare un cookie.

Utilizza questa funzione per assicurarti che le pagine siano conformi al consenso degli utenti per quanto riguarda l’utilizzo dei cookie.

Configurazione dei cookie consentiti

Configura il servizio di rinuncia di Adobe Granite per specificare come vengono utilizzati i cookie sulle pagine web. La tabella seguente descrive le proprietà che puoi configurare.

Per configurare il servizio, puoi utilizzare Console web o aggiungere una configurazione OSGi all’archivio. Nella tabella seguente vengono descritte le proprietà necessarie per entrambi i metodi. Per una configurazione OSGi, il PID del servizio è com.adobe.granite.optout.

Nome proprietà (console Web) Nome proprietà OSGi Descrizione
Cookie di rinuncia optout.cookies I nomi dei cookie che indicano, quando presenti sul dispositivo dell’utente, che quest’ultimo non ha acconsentito all’utilizzo dei cookie.
Intestazioni HTTP di rinuncia optout.headers I nomi delle intestazioni HTTP che indicano, se presenti, che l’utente non ha acconsentito all’utilizzo dei cookie.
Cookie della whitelist optout.whitelist.cookies Un elenco di cookie che sono essenziali per il funzionamento del sito web e possono essere utilizzati senza il consenso di un utente.

Utilizza JavaScript lato client per chiamare il servizio Opt-out di Adobe Granite e verificare che sia possibile utilizzare un cookie. Utilizzare l'oggetto javascript Granite.OptOutUtil per eseguire una delle operazioni seguenti:

  • Ottieni un elenco di nomi di cookie che indicano che l’utente non acconsente all’utilizzo dei cookie a scopo di tracciamento.
  • Ottieni un elenco di cookie che possono essere utilizzati.
  • Determina se il browser web contiene un cookie che indica che l’utente non acconsente all’utilizzo dei cookie per il tracciamento.
  • Determina se è possibile utilizzare un cookie specifico.

Granite.utils cartella della libreria client fornisce l'oggetto Granite.OptOutUtil. Aggiungi il seguente codice al codice JSP dell'intestazione della pagina per includere un collegamento alla libreria JavaScript:

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

Ad esempio, la seguente funzione javascript determina se è consentito utilizzare il cookie COOKIE_NAME prima di scrivervi:

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

Oggetto Javascript Granite.OptOutUtil

Granite.OptOutUtil consente di determinare se l'utilizzo dei cookie è consentito.

funzione getCookieNames()

Restituisce i nomi dei cookie che, se presenti, indicano che l’utente non ha dato il consenso all’uso dei cookie.

Parametri

Nessuno.

Restituisce

Matrice di nomi di cookie.

funzione getWhitelistCookieNames()

Restituisce i nomi dei cookie che possono essere utilizzati indipendentemente dal consenso dell’utente.

Parametri

Nessuno.

Restituisce

Matrice di nomi di cookie.

isOptedOut(), funzione

Determina se il browser dell’utente contiene cookie che indicano che non è stato fornito il consenso all’utilizzo dei cookie.

Parametri

Nessuno.

Restituisce

Valore booleano di true se viene trovato un cookie che indica assenza di consenso e un valore di false se nessun cookie indica il mancato consenso.

funzione maySetCookie(cookieName)

Determina se è possibile utilizzare un cookie specifico nel browser dell'utente. Questa funzione equivale a utilizzare il isOptedOut per determinare se il cookie specificato è incluso nell’elenco che il cookie getWhitelistCookieNames restituisce.

Parametri

  • cookieName: stringa. Nome del cookie.

Restituisce

Valore booleano di true se cookieName può essere utilizzato o un valore di false se cookieName non può essere utilizzato.

In questa pagina