Configuração do uso de cookies

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 javascript permite que seu código javascript verifique se um cookie pode ser usado.

Use esse 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

Configure o serviço de cancelamento de Adobe Granite para especificar como os cookies são usados em suas páginas da Web. A tabela a seguir descreve as propriedades que você pode configurar.

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

Validação do uso do cookie

Use o javascript do lado do cliente para ligar para o serviço de cancelamento de Adobe Granite para verificar se você pode usar um cookie. Use o objeto javascript Granite.OptOutUtil para executar qualquer uma das seguintes tarefas:

• Obtenha uma lista de nomes de cookies que indicam que o usuário não concorda 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 concorda com o uso de cookies para rastreamento.
• Determine se um cookie específico pode ser usado.

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

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

Por exemplo, a seguinte função javascript determina se o cookie COOKIE_NAME pode ser usado 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 JavaScript Granite.OptOutUtil

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

função getCookieNames()

Retorna os nomes dos cookies que, quando presentes, indicam que o usuário não deu consentimento para o uso de cookies.

Parâmetros

Nenhum.

Retorna

Uma matriz de nomes de cookies.

função getWhitelistCookieNames()

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

Parâmetros

Nenhum.

Retorna

Uma matriz de nomes de cookies.

função isOptedOut()

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

Parâmetros

Nenhum.

Retorna

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

função MaySetCookie(cookieName)

Determina se um cookie específico pode ser usado no navegador do usuário. Essa função equivale a usar a função isOptedOut em conjunto com a determinação de se o cookie especificado está incluído na lista retornada pela função getWhitelistCookieNames.

Parâmetros

• cookieName: String. O nome do cookie.

Retorna

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