Configuration de l’utilisation de cookies

Dernière mise à jour : 2023-05-04
  • Créé pour :
  • Developer
ATTENTION

AEM 6.4 a atteint la fin de la prise en charge étendue et cette documentation n’est plus mise à jour. Pour plus d’informations, voir notre période de support technique. Rechercher les versions prises en charge here.

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

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.

Nom de la propriété (console web) Nom de propriété OSGi Description
Cookies de droit d’opposition optout.cookies Les noms des cookies qui indiquent, lorsqu’ils sont présents sur l’appareil de l’utilisateur, que celui-ci n’a pas consenti à utiliser les cookies.
En-têtes HTTP de droit d’opposition optout.headers Les noms des en-têtes HTTP qui indiquent, lorsqu’ils sont présents, que l’utilisateur n’a pas consenti à l’utilisation de cookies.
Cookies de liste autorisée optout.whitelist.cookies Liste des cookies qui sont essentiels au fonctionnement du site Web et qui peuvent être utilisés sans le consentement de l’utilisateur.

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

Granite.OptOutUtil vous permet de déterminer si l’utilisation des cookies est autorisée.

fonction getCookieNames()

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

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

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)

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.

Sur cette page