Configuration de l’utilisation de cookies configuring-cookie-usage
AEM fournit un service qui vous permet de configurer et de contrôler la manière dont les cookies sont utilisés avec vos pages web :
- Un service côté serveur configurable conserve une liste de cookies pouvant être utilisés.
- Une API JavaScript permet à votre code JavaScript de vérifier qu’un cookie peut être utilisé.
Utilisez cette fonction pour vous assurer que vos pages respectent le consentement de vos utilisateurs concernant l’utilisation des cookies.
Configuration des cookies autorisés configuring-allowed-cookies
Configurez le service d’exclusion Granite Adobe pour spécifier la manière dont les cookies sont utilisés sur vos pages web. Le tableau suivant décrit les propriétés que vous pouvez configurer.
Pour configurer le service, vous pouvez utiliser la console Web ou ajouter une configuration OSGi au référentiel. Le tableau suivant décrit les propriétés dont vous avez besoin pour l’une ou l’autre de ces méthodes. Pour une configuration OSGi, le PID du service est com.adobe.granite.optout.
Validation de l’utilisation des cookies validating-cookie-usage
Utilisez JavaScript côté client pour appeler le service d’exclusion Granite Adobe afin de vérifier que vous pouvez utiliser un cookie. Utilisez l’objet JavaScript Granite.OptOutUtil pour effectuer l’une des tâches suivantes :
- Obtenez une liste de noms de cookie indiquant que cet utilisateur n’autorise pas l’utilisation de cookies à des fins de suivi.
- Obtenez la liste des cookies qui peuvent être utilisés.
- Déterminez si le navigateur Web contient un cookie qui indique que l’utilisateur ne consent pas à l’utilisation des cookies pour le suivi.
- Déterminez si un cookie spécifique peut être utilisé.
granite.utils dossier de bibliothèque cliente fournit l’objet Granite.OptOutUtil . Ajoutez le code suivant au JSP de l’en-tête de la page pour inclure un lien vers la bibliothèque JavaScript :
<ui:includeClientLib categories="granite.utils" />
Par exemple, la fonction JavaScript suivante détermine si le cookie COOKIE_NAME est autorisé à être utilisé avant d’y écrire :
function writeCookie(value){
if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
return;
if (value) {
value = encodeURIComponent(value);
document.cookie = "COOKIE_NAME=" + value;
}
}
Objet JavaScript Granite.OptOutUtil the-granite-optoututil-javascript-object
Granite.OptOutUtil vous permet de déterminer si l’utilisation des cookies est autorisée.
fonction getCookieNames() getcookienames-function
Renvoie les noms des cookies qui, lorsqu’ils sont présents, indiquent que l’utilisateur n’a pas donné son consentement à l’utilisation des cookies.
Paramètres
Aucun.
Renvoie
Tableau de noms de cookies.
fonction getWhitelistCookieNames() getwhitelistcookienames-function
Renvoie les noms des cookies qui peuvent être utilisés, quel que soit le consentement de l’utilisateur.
Paramètres
Aucun.
Renvoie
Tableau de noms de cookies.
fonction isOptedOut() isoptedout-function
Détermine si le navigateur de l’utilisateur contient des cookies qui indiquent que le consentement n’a pas été donné pour utiliser des cookies.
Paramètres
Aucun.
Renvoie
Valeur booléenne true si un cookie indique que l’autorisation n’a pas été accordée et valeur false si aucun cookie n’indique une absence d’autorisation.
fonction maySetCookie(cookieName) maysetcookie-cookiename-function
Détermine si un cookie spécifique peut être utilisé sur le navigateur de l’utilisateur. Cette fonction revient à utiliser isOptedOut parallèlement à la fonction permettant de déterminer si le cookie en question est inclus dans la liste renvoyée par la fonction getWhitelistCookieNames.
Paramètres
- cookieName : Chaîne. Nom du cookie.
Renvoie
Valeur booléenne true si cookieName peut être utilisé et valeur false si cookieName ne peut pas l’être.