쿠키 사용 구성 configuring-cookie-usage

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.

AEM은 웹 페이지에서 쿠키가 사용되는 방식을 구성하고 제어할 수 있도록 해주는 서비스를 제공합니다.

  • 구성 가능한 서버측 서비스는 사용할 수 있는 쿠키 목록을 유지합니다.
  • Javascript API를 사용하면 Javascript 코드에서 쿠키가 사용될 수 있는지 확인할 수 있습니다.

이 기능을 사용하여 페이지가 쿠키 사용에 대한 사용자의 동의를 준수하도록 하십시오.

허용된 쿠키 구성 configuring-allowed-cookies

Granite 옵트아웃 서비스 Adobe을 구성하여 웹 페이지에서 쿠키가 사용되는 방식을 지정합니다. 다음 표에서는 구성할 수 있는 속성에 대해 설명합니다.

서비스를 구성하려면 웹 콘솔 또는 저장소에 OSGi 구성 추가. 다음 표에서는 두 방법 중 하나에 필요한 속성에 대해 설명합니다. OSGi 구성의 경우 서비스 PID는 다음과 같습니다 com.adobe.granite.optout.

속성 이름 (웹 콘솔)
OSGi 속성 이름
설명
옵트아웃 쿠키
optout.cookies
사용자의 장치에 있을 때 사용자가 쿠키 사용에 동의하지 않았음을 나타내는 쿠키의 이름입니다.
옵트아웃 HTTP 헤더
optout.headers
사용자가 쿠키 사용에 동의하지 않았음을 나타내는 HTTP 헤더의 이름입니다.
허용 목록 쿠키
optout.whitelist.cookies
웹 사이트의 기능에 중요하며 사용자의 동의 없이 사용할 수 있는 쿠키 목록입니다.

클라이언트측 Javascript를 사용하여 Granite 옵트아웃 서비스를 호출하여 Adobe을 사용할 수 있는지 확인합니다. 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

사용자의 브라우저에서 특정 쿠키를 사용할 수 있는지 여부를 결정합니다. 이 함수는 isOptedOut 를 사용하여 해당 쿠키를 getWhitelistCookieNames 함수를 반환합니다.

매개변수

  • cookieName: 문자열. 쿠키의 이름입니다.

반환

부울 값 true if cookieName 를 사용하거나 false if cookieName 사용할 수 없습니다.

recommendation-more-help
2315f3f5-cb4a-4530-9999-30c8319c520e