Configuración del uso de cookies configuring-cookie-usage
AEM proporciona un servicio que le permite configurar y controlar cómo se utilizan las cookies con las páginas web:
- Un servicio configurable del lado del servidor mantiene una lista de cookies que se pueden utilizar.
- Una API de javascript permite que su código javascript compruebe que se puede utilizar una cookie.
Utilice esta función para asegurarse de que las páginas cumplen con el consentimiento de los usuarios con respecto al uso de cookies.
Configuración de las cookies permitidas configuring-allowed-cookies
Configure el servicio de exclusión de Adobe Granite para especificar cómo se utilizan las cookies en las páginas web. En la tabla siguiente se describen las propiedades que se pueden configurar.
Para configurar el servicio, puede utilizar la variable Consola web o añadir una configuración OSGi al repositorio. En la tabla siguiente se describen las propiedades que necesita para cualquiera de los métodos. Para una configuración OSGi, el PID de servicio es com.adobe.granite.optout.
Validación del uso de cookies validating-cookie-usage
Utilice javascript del lado del cliente para llamar al servicio de exclusión de Adobe Granite y comprobar que puede utilizar una cookie. Utilice el objeto javascript Granite.OptOutUtil para realizar cualquiera de las siguientes tareas:
- Obtenga una lista de nombres de cookies que indique que el usuario no da su consentimiento para usar cookies con fines de seguimiento.
- Obtenga una lista de cookies que se pueden utilizar.
- Determine si el explorador web contiene una cookie que indica que el usuario no da su consentimiento para el uso de cookies para el seguimiento.
- Determine si se puede usar una cookie específica.
El granito.utils carpeta de biblioteca cliente proporciona el objeto Granite.OptOutUtil . Agregue el siguiente código al JSP del encabezado de la página para incluir un vínculo a la biblioteca javascript:
<ui:includeClientLib categories="granite.utils" />
Por ejemplo, la siguiente función de javascript determina si se permite utilizar la cookie COOKIE_NAME antes de escribirla:
function writeCookie(value){
if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
return;
if (value) {
value = encodeURIComponent(value);
document.cookie = "COOKIE_NAME=" + value;
}
}
El objeto JavaScript Granite.OptOutUtil the-granite-optoututil-javascript-object
Granite.OptOutUtil le permite determinar si se permite el uso de cookies.
getCookieNames(), función getcookienames-function
Devuelve los nombres de las cookies que, cuando están presentes, indican que el usuario no ha dado su consentimiento para el uso de cookies.
Parámetros
Ninguna.
Devuelve
Matriz de nombres de cookies.
función getWhitelistCookieNames() getwhitelistcookienames-function
Devuelve los nombres de las cookies que se pueden usar independientemente del consentimiento del usuario.
Parámetros
Ninguna.
Devuelve
Matriz de nombres de cookies.
isOptedOut(), función isoptedout-function
Determina si el explorador del usuario contiene cookies que indican que no se ha dado el consentimiento para usar cookies.
Parámetros
Ninguna.
Devuelve
Un valor booleano de true si se encuentra una cookie que indica que no hay consentimiento, y un valor de false si ninguna cookie indica no consentimiento.
función maySetCookie(cookieName) maysetcookie-cookiename-function
Determina si se puede usar una cookie específica en el explorador del usuario. Esta función equivale a usar la variable isOptedOut junto con la determinación de si la cookie dada está incluida en la lista de que getWhitelistCookieNames devuelve.
Parámetros
- cookieName: Cadena. Nombre de la cookie.
Devuelve
Un valor booleano de true if cookieName puede utilizarse, o bien un valor de false if cookieName no se puede usar.