設定Cookie使用情形 configuring-cookie-usage

CAUTION
AEM 6.4已結束延伸支援,本檔案不再更新。 如需詳細資訊,請參閱 技術支援期. 尋找支援的版本 此處.

AEM提供的服務可讓您設定及控制如何在您的網頁中使用cookie:

  • 可設定的伺服器端服務會維護可使用的Cookie清單。
  • Javascript API可讓您的Javascript程式碼驗證是否可使用Cookie。

使用此功能可確保您的頁面符合使用者對Cookie使用方式的同意。

設定允許的Cookie configuring-allowed-cookies

設定AdobeGranite選擇退出服務,以指定在您的網頁上使用Cookie的方式。 下表說明了可配置的屬性。

若要設定服務,您可以使用 Web主控台將OSGi設定新增至存放庫. 下表說明了任何一種方法所需的屬性。 若為OSGi設定,服務PID為 com.adobe.granite.optout.

屬性名稱(Web主控台)
OSGi屬性名稱
說明
退出Cookie
optout.cookies
當Cookie出現在使用者裝置上時,表示使用者未同意使用Cookie的Cookie名稱。
退出HTTP標題
optout.headers
HTTP標題的名稱,在出現時指出使用者未同意使用Cookie。
白名單Cookie
optout.whitelist.cookies
對網站運作至關重要且未經使用者同意即可使用的Cookie清單。

使用用戶端javascript來呼叫AdobeGranite選擇退出服務,以確認您可以使用Cookie。 使用Granite.OptOutUtil Javascript物件執行下列任一作業:

  • 取得Cookie名稱清單,指出該使用者不同意將Cookie用於追蹤用途。
  • 取得可使用的Cookie清單。
  • 判斷網頁瀏覽器是否包含指出使用者不同意使用Cookie進行追蹤的Cookie。
  • 判斷是否可使用特定Cookie。

granite.utils 用戶庫資料夾 提供Granite.OptOutUtil物件。 將下列程式碼新增至您的頁面標題JSP,以包含javascript程式庫的連結:

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

例如,下列javascript函式會決定在寫入COOKIE_NAME Cookie之前,是否允許使用COOKIE_NAME Cookie:

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可讓您判斷是否允許使用Cookie。

getCookieNames()函式 getcookienames-function

傳回Cookie的名稱,若存在,即表示使用者未同意使用Cookie。

參數

無.

傳回

Cookie名稱的陣列。

getWhitelistCookieNames()函式 getwhitelistcookienames-function

傳回無論使用者同意為何皆可使用的Cookie名稱。

參數

無.

傳回

Cookie名稱的陣列。

isOptedOut()函式 isoptedout-function

判斷使用者的瀏覽器是否包含任何表示尚未同意使用Cookie的Cookie。

參數

無.

傳回

的布林值 true 若找到未表示同意的Cookie,則 false 如果沒有cookie表示不同意。

maySetCookie(cookieName)函式 maysetcookie-cookiename-function

判斷是否可在使用者的瀏覽器上使用特定Cookie。 此函式等同於使用 isOptedOut 函式,並判斷指定的Cookie是否包含在 getWhitelistCookieNames 函式會傳回。

參數

  • cookieName:字串。 Cookie的名稱。

傳回

的布林值 true if cookieName 可供使用,或 false if cookieName 無法使用。

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