Configurazione dell’utilizzo dei cookie configuring-cookie-usage

CAUTION
AEM 6.4 ha raggiunto la fine del supporto esteso e questa documentazione non viene più aggiornata. Per maggiori dettagli, consulta la nostra periodi di assistenza tecnica. Trova le versioni supportate qui.

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 abilita il codice javascript per verificare che possa essere utilizzato un cookie.

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

Configura l'Adobe Servizio di rinuncia di Granite per specificare il modo in cui i cookie vengono utilizzati nelle pagine web. La tabella seguente descrive le proprietà che puoi configurare.

Per configurare il servizio, puoi utilizzare la funzione Console web o aggiungi una configurazione OSGi all’archivio. Nella tabella seguente sono 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
Nomi dei cookie che indicano, se presenti sul dispositivo dell'utente, che l'utente non ha acconsentito all'uso dei cookie.
Intestazioni HTTP Opt-Out
optout.headers
I nomi delle intestazioni HTTP che indicano, se presenti, che l'utente non ha acconsentito all'uso dei cookie.
Cookie della whitelist
optout.whitelist.cookies
Un elenco di cookie essenziali per il funzionamento del sito web e utilizzabili senza il consenso dell'utente.

Utilizza javascript lato client per chiamare Adobe Granite Opt-Out Service per verificare di poter utilizzare un cookie. Utilizzare l'oggetto javascript Granite.OptOutUtil per eseguire una delle seguenti attività:

  • 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.
  • Stabilisci se il browser web contiene un cookie che indica che l’utente non acconsente all’utilizzo di cookie per il tracciamento.
  • Determina se è possibile utilizzare un cookie specifico.

Granite.utils cartella libreria client fornisce l'oggetto Granite.OptOutUtil . Aggiungi il seguente codice al tuo codice JSP per includere un collegamento alla libreria javascript:

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

Ad esempio, la seguente funzione javascript determina se il cookie COOKIE_NAME può essere utilizzato prima di scriverlo:

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

Oggetto Javascript Granite.OptOutUtil the-granite-optoututil-javascript-object

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

funzione getCookieNames() getcookienames-function

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() getwhitelistcookienames-function

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

Parametri

Nessuno.

Restituisce

Matrice di nomi di cookie.

isOptedOut(), funzione isoptedout-function

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

Parametri

Nessuno.

Restituisce

Un valore booleano di true se viene trovato un cookie che indica l’assenza di consenso e un valore di false se nessun cookie indica la mancata autorizzazione.

funzione maySetCookie(cookieName) maysetcookie-cookiename-function

Determina se è possibile utilizzare un cookie specifico nel browser dell'utente. Equivale a utilizzare la funzione isOptedOut in combinazione con determinare se il cookie dato è incluso nell'elenco che getWhitelistCookieNames restituisce la funzione .

Parametri

  • cookieName: Stringa. Nome del cookie.

Restituisce

Un valore booleano di true if cookieName può essere utilizzato, oppure un valore di false if cookieName non può essere utilizzato.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e