쿠키 사용 구성 configuring-cookie-usage
AEM은 웹 페이지에서 쿠키가 사용되는 방법을 구성하고 제어할 수 있는 서비스를 제공합니다.
- 구성 가능한 서버측 서비스는 사용할 수 있는 쿠키 목록을 유지 관리합니다.
- JavaScript API를 사용하면 JavaScript 코드에서 쿠키를 사용할 수 있는지 확인할 수 있습니다.
이 기능을 사용하여 페이지가 쿠키 사용에 대한 사용자의 동의를 준수하는지 확인하십시오.
허용된 쿠키 구성 configuring-allowed-cookies
Adobe Granite 옵트아웃 서비스를 구성하여 웹 페이지에서 쿠키가 사용되는 방법을 지정합니다. 다음 표에서는 구성할 수 있는 속성에 대해 설명합니다.
서비스를 구성하려면 웹 콘솔 또는 저장소에 OSGi 구성을 추가할 수 있습니다. 다음 표에서는 두 가지 방법에 필요한 속성을 설명합니다. OSGi 구성의 경우 서비스 PID는 com.adobe.granite.optout
입니다.
쿠키 사용 확인 validating-cookie-usage
클라이언트측 JavaScript을 사용하여 Adobe Granite 옵트아웃 서비스를 호출하여 쿠키를 사용할 수 있는지 확인합니다. Granite.OptOutUtil JavaScript 개체를 사용하여 다음 작업을 수행합니다.
- 해당 사용자가 추적 목적으로 쿠키를 사용하는 것에 동의하지 않음을 나타내는 쿠키 이름 목록을 얻습니다.
- 사용할 수 있는 쿠키 목록을 얻습니다.
- 웹 브라우저에 사용자가 추적을 위한 쿠키 사용에 동의하지 않음을 나타내는 쿠키가 포함되어 있는지 여부를 확인합니다.
- 특정 쿠키를 사용할 수 있는지 여부를 결정합니다.
granite.utils 클라이언트 라이브러리 폴더는 Granite.OptOutUtil 개체를 제공합니다. 페이지 헤드 JSP에 다음 코드를 추가하여 JavaScript 라이브러리에 대한 링크를 포함합니다.
<ui:includeClientLib categories="granite.utils" />
예를 들어 다음 JavaScript 함수는 COOKIE_NAME 쿠키에 쓰기 전에 사용할 수 있는지 여부를 결정합니다.
function writeCookie(value){
if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
return;
if (value) {
value = encodeURIComponent(value);
document.cookie = "COOKIE_NAME=" + value;
}
}
Granite.OptOutUtil JavaScript 개체 the-granite-optoututil-javascript-object
Granite.OptOutUtil을 사용하면 쿠키 사용이 허용되는지 여부를 확인할 수 있습니다.
getCookieNames() 함수 getcookienames-function
존재하는 경우 사용자가 쿠키 사용에 동의하지 않았음을 나타내는 쿠키 이름.
매개변수
없음.
반환
쿠키 이름의 배열입니다.
getWhitelistCookieNames() 함수 getwhitelistcookienames-function
사용자의 동의에 관계없이 사용할 수 있는 쿠키의 이름입니다.
매개변수
없음.
반환
쿠키 이름의 배열입니다.
isOptedOut() 함수 isoptedout-function
사용자의 브라우저에 쿠키 사용에 동의하지 않았음을 나타내는 쿠키가 포함되어 있는지 여부를 결정합니다.
매개변수
없음.
반환
동의 없음을 나타내는 쿠키가 있는 경우 true
의 부울 값, 동의 없음을 나타내는 쿠키가 없는 경우 false
의 값.
maySetCookie(cookieName) 함수 maysetcookie-cookiename-function
사용자의 브라우저에서 특정 쿠키를 사용할 수 있는지 여부를 결정합니다. 이 함수는 getWhitelistCookieNames
함수가 반환하는 목록에 지정된 쿠키가 포함되어 있는지 여부를 확인하는 데 isOptedOut
함수를 사용하는 것과 같습니다.
매개변수
- cookieName: 문자열 쿠키의 이름입니다.
반환
cookieName
을(를) 사용할 수 있는 경우 부울 값 true
, cookieName
을(를) 사용할 수 없는 경우 값 false
입니다.