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 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 do cookie.
Configuração de cookies permitidos configuring-allowed-cookies
Configure o serviço de cancelamento do Adobe Granite para especificar como os cookies são usados nas páginas da Web. A tabela a seguir descreve as propriedades que você pode configurar.
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.
Validação do uso de cookies validating-cookie-usage
Use o javascript do lado do cliente para chamar o Adobe Granite Opt-Out Service e 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 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 concorda com o uso de cookies para rastreamento.
- Determine se um cookie específico pode ser usado.
O granite.utils pasta da biblioteca do cliente fornece o objeto Granite.OptOutUtil . Adicione o seguinte código ao JSP do cabeçalho da página para incluir um link para a biblioteca 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 the-granite-optoututil-javascript-object
O Granite.OptOutUtil permite determinar se o uso de cookies é permitido.
função getCookieNames() getcookienames-function
Retorna 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
Retorna 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 usar cookies.
Parâmetros
Nenhum.
Devoluções
Um valor booleano de true se for encontrado um cookie que indica nenhum 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. Essa função equivale a usar a variável isOptedOut , juntamente com a determinação de que o cookie especificado está incluído na lista que getWhitelistCookieNames retorna.
Parâmetros
- cookieName: Sequência de caracteres. O nome do cookie.
Devoluções
Um valor booleano de true if cookieName pode ser usado, ou um valor de false if cookieName não pode ser usada.