AEM提供的服務可讓您設定及控制如何在您的網頁中使用cookie:
使用此功能可確保您的頁面符合使用者對Cookie使用方式的同意。
設定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物件執行下列任一作業:
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可讓您判斷是否允許使用Cookie。
傳回Cookie的名稱,若存在,即表示使用者未同意使用Cookie。
參數
無.
傳回
Cookie名稱的陣列。
傳回無論使用者同意為何皆可使用的Cookie名稱。
參數
無.
傳回
Cookie名稱的陣列。
判斷使用者的瀏覽器是否包含任何表示尚未同意使用Cookie的Cookie。
參數
無.
傳回
的布林值 true
若找到未表示同意的Cookie,則 false
如果沒有cookie表示不同意。
判斷是否可在使用者的瀏覽器上使用特定Cookie。 此函式等同於使用 isOptedOut
函式,並判斷指定的Cookie是否包含在 getWhitelistCookieNames
函式會傳回。
參數
傳回
的布林值 true
if cookieName
可供使用,或 false
if cookieName
無法使用。