Configurazione dell’utilizzo dei cookie configuring-cookie-usage
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 di 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 configuring-allowed-cookies
Configura il servizio di rinuncia di Adobe Granite per specificare come vengono utilizzati i cookie sulle pagine web. Nella tabella seguente sono descritte le proprietà che è possibile configurare.
Per configurare il servizio, è possibile utilizzare la 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.
Convalida dell’utilizzo dei cookie validating-cookie-usage
Utilizza JavaScript lato client per chiamare il servizio Opt-out di Adobe Granite e verificare di poter 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.
La cartella della libreria client di granite.utils fornisce l'oggetto Granite.OptOutUtil. Aggiungi il seguente codice all'intestazione della pagina JSP per includere un collegamento alla libreria JavaScript:
<ui:includeClientLib categories="granite.utils" />
Ad esempio, la seguente funzione di JavaScript determina se il cookie COOKIE_NAME può essere utilizzato 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 the-granite-optoututil-javascript-object
Granite.OptOutUtil consente di determinare se l'utilizzo dei cookie è consentito.
funzione getCookieNames() getcookienames-function
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
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 fornito il consenso all’utilizzo dei cookie.
Parametri
Nessuno.
Restituisce
Valore booleano true se viene trovato un cookie che indica che non c'è consenso e valore false se nessun cookie indica che non c'è consenso.
funzione maySetCookie(cookieName) maysetcookie-cookiename-function
Determina se è possibile utilizzare un cookie specifico nel browser dell'utente. Questa funzione equivale a utilizzare la funzione isOptedOut per determinare se il cookie specificato è incluso nell'elenco restituito dalla funzione getWhitelistCookieNames.
Parametri
- cookieName: stringa. Nome del cookie.
Restituisce
Valore booleano true se è possibile utilizzare cookieName oppure valore false se non è possibile utilizzare cookieName.