Configuração do uso de cookies configuring-cookie-usage

O AEM fornece um serviço que permite configurar e controlar como os cookies são usados com suas páginas da Web:

  • Um serviço configurável do lado do servidor mantém uma lista de cookies que podem ser usados.
  • Uma API do JavaScript permite que o código JavaScript verifique se um cookie pode ser usado.

Use este recurso para garantir que suas páginas estejam em conformidade com o consentimento dos usuários em relação ao uso de cookies.

Configuração de cookies permitidos configuring-allowed-cookies

Configure o Serviço de recusa do Adobe Granite para especificar como os cookies são usados em suas páginas da Web. A tabela a seguir descreve as propriedades que podem ser configuradas.

Para configurar o serviço, você pode usar o Console da Web ou adicionar uma configuração OSGi ao repositório. A tabela a seguir descreve as propriedades necessárias para qualquer método. Para uma configuração OSGi, o PID do serviço é com.adobe.granite.optout.

Nome da propriedade (console da Web)
Nome da propriedade OSGi
Descrição
Cookies de recusa
optout.cookies
Os nomes dos cookies que indicam, quando presentes no dispositivo do usuário, que ele não consentiu em usar cookies.
Cabeçalhos HTTP de recusa
optout.headers
Os nomes dos cabeçalhos HTTP que indicam, quando presentes, que o usuário não consentiu em usar cookies.
Cookies da lista de permissões
optout.whitelist.cookies
Uma lista de cookies essenciais para o funcionamento do site, e que podem ser usados sem o consentimento do usuário.

Use o JavaScript do lado do cliente para chamar o Serviço de recusa do Adobe Granite para verificar se você pode usar um cookie. Use o objeto de JavaScript Granite.OptOutUtil para executar qualquer uma das seguintes tarefas:

  • Obtenha uma lista de nomes de cookies que indicam que esse usuário não consente em usar cookies para fins de rastreamento.
  • Obtenha uma lista de cookies que podem ser usados.
  • Determine se o navegador da Web contém um cookie que indica que o usuário não consente com o uso de cookies para rastreamento.
  • Determine se um cookie específico pode ser usado.

A pasta da biblioteca do cliente do granite.utils fornece o objeto Granite.OptOutUtil. Adicione o seguinte código à JSP do cabeçalho da página para incluir um link à biblioteca do JavaScript:

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

Por exemplo, a seguinte função do JavaScript determina se o cookie COOKIE_NAME é permitido para uso antes de gravar nele:

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

O objeto Granite.OptOutUtil do JavaScript the-granite-optoututil-javascript-object

Granite.OptOutUtil permite determinar se o uso de cookies é permitido.

função getCookieNames() getcookienames-function

Os nomes dos cookies que, quando presentes, indicam que o usuário não consentiu com o uso de cookies.

Parâmetros

Nenhum.

Devoluções

Uma matriz de nomes de cookies.

função getWhitelistCookieNames() getwhitelistcookienames-function

Os nomes dos cookies que podem ser usados independentemente do consentimento do usuário.

Parâmetros

Nenhum.

Devoluções

Uma matriz de nomes de cookies.

função isOptedOut() isoptedout-function

Determina se o navegador do usuário contém cookies que indicam que não foi dado consentimento para o uso de cookies.

Parâmetros

Nenhum.

Devoluções

Um valor booliano de true se for encontrado um cookie que indica ausência de consentimento, e um valor de false se nenhum cookie indicar não consentimento.

função maySetCookie(cookieName) maysetcookie-cookiename-function

Determina se um cookie específico pode ser usado no navegador do usuário. Esta função é equivalente a usar a função isOptedOut para determinar se o cookie fornecido está incluído na lista retornada pela função getWhitelistCookieNames.

Parâmetros

  • cookieName: cadeia de caracteres. O nome do cookie.

Devoluções

Um valor booliano de true se cookieName puder ser usado, ou um valor de false se cookieName não puder ser usado.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2