Konfigurieren der Verwendung von Cookies configuring-cookie-usage

CAUTION
AEM 6.4 hat das Ende der erweiterten Unterstützung erreicht und diese Dokumentation wird nicht mehr aktualisiert. Weitere Informationen finden Sie in unserer technische Unterstützung. Unterstützte Versionen suchen here.

AEM bietet einen Dienst, mit dem Sie konfigurieren und steuern können, wie Cookies mit Ihren Webseiten verwendet werden:

  • Ein konfigurierbarer Server-seitiger Dienst verwaltet eine Liste von Cookies, die verwendet werden können.
  • Mit einer JavaScript-API kann Ihr JavaScript-Code überprüfen, ob ein Cookie verwendet werden kann.

Verwenden Sie diese Funktion, um sicherzustellen, dass Ihre Seiten die Zustimmung Ihrer Benutzer zur Cookie-Nutzung einhalten.

Konfigurieren zulässiger Cookies configuring-allowed-cookies

Konfigurieren Sie den Opt-out-Dienst der Adobe Granite , um festzulegen, wie Cookies auf Ihren Webseiten verwendet werden. In der folgenden Tabelle werden die Eigenschaften beschrieben, die Sie konfigurieren können.

Zum Konfigurieren des Dienstes können Sie die Web-Konsole verwenden oder eine OSGi-Konfiguration zum Repository hinzufügen. In der folgenden Tabelle werden die Eigenschaften beschrieben, die für beide Methoden erforderlich sind. Für eine OSGi-Konfiguration lautet die PID des Dienstes com.adobe.granite.optout.

Eigenschaftsname (Web-Konsole)
OSGi-Eigenschaftsname
Beschreibung
Opt-out-Cookies
optout.cookies
Die Namen von Cookies, die, wenn sie auf dem Gerät des Benutzers vorhanden sind, anzeigen, dass der Benutzer der Verwendung von Cookies nicht zugestimmt hat.
HTTP-Header für Opt-out
optout.headers
Die Namen der HTTP-Header, die, wenn vorhanden, anzeigen, dass der Benutzer der Verwendung von Cookies nicht zugestimmt hat.
Cookies auf der Zulassungsliste
optout.whitelist.cookies
Eine Liste von Cookies, die für die Funktionalität der Website unerlässlich sind und ohne Zustimmung des Benutzers verwendet werden können.

Verwenden Sie Client-seitiges JavaScript, um den Adobe Granite Opt-Out Service aufzurufen und zu überprüfen, ob Sie Cookies verwenden können. Verwenden Sie das JavaScript-Objekt Granite.OptOutUtil , um eine der folgenden Aufgaben auszuführen:

  • Rufen Sie eine Liste mit Cookie-Namen ab, die darauf hinweisen, dass der Benutzer der Verwendung von Cookies zu Tracking-Zwecken nicht zustimmt.
  • Rufen Sie eine Liste von Cookies ab, die verwendet werden können.
  • Bestimmen Sie, ob der Webbrowser ein Cookie enthält, das anzeigt, dass der Benutzer der Verwendung von Cookies zum Tracking nicht zustimmt.
  • Bestimmen Sie, ob ein bestimmtes Cookie verwendet werden kann.

Die granite.utils Client-Bibliotheksordner stellt das Objekt Granite.OptOutUtil bereit. Fügen Sie Ihrem Seitenkopf-JSP den folgenden Code hinzu, um einen Link zur JavaScript-Bibliothek einzuschließen:

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

Beispielsweise bestimmt die folgende JavaScript-Funktion, ob das Cookie COOKIE_NAME vor dem Schreiben in verwendet werden darf:

function writeCookie(value){
   if (!Granite.OptOutUtil.maySetCookie("COOKIE_NAME"))
      return;
   if (value) {
      value = encodeURIComponent(value);
      document.cookie = "COOKIE_NAME=" + value;
   }
}

Das JavaScript-Objekt Granite.OptOutUtil the-granite-optoututil-javascript-object

Mit Granite.OptOutUtil können Sie bestimmen, ob die Verwendung von Cookies zulässig ist.

Funktion "getCookieNames()" getcookienames-function

Gibt die Namen der Cookies zurück, die, sofern vorhanden, darauf hinweisen, dass der Benutzer der Verwendung von Cookies nicht zugestimmt hat.

Parameter

Ohne.

Rückgabe

Ein Array von Cookie-Namen.

Funktion "getWhitelistCookieNames()" getwhitelistcookienames-function

Gibt die Namen der Cookies zurück, die unabhängig von der Zustimmung des Benutzers verwendet werden können.

Parameter

Ohne.

Rückgabe

Ein Array von Cookie-Namen.

isOptedOut()-Funktion isoptedout-function

Bestimmt, ob der Browser des Benutzers Cookies enthält, die darauf hinweisen, dass die Verwendung von Cookies nicht genehmigt wurde.

Parameter

Ohne.

Rückgabe

Einen booleschen Wert, der true lautet, wenn ein Cookie gefunden wird, das darauf hinweist, dass keine Zustimmung erteilt wurde, und false lautet, wenn kein Cookie darauf hinweist, dass keine Zustimmung erteilt wurde.

Funktion "maySetCookie(cookieName)" maysetcookie-cookiename-function

Bestimmt, ob ein bestimmtes Cookie im Browser des Benutzers verwendet werden kann. Diese Funktion entspricht der Verwendung der Funktion isOptedOut, wobei zusätzlich ermittelt wird, ob das angegebene Cookie in der Liste enthalten ist, die die Funktion getWhitelistCookieNames zurückgibt.

Parameter

  • cookieName: Zeichenfolge. Der Name des Cookies.

Rückgabe

Einen booleschen Wert, der true lautet, wenn cookieName verwendet werden kann, oder false lautet, wenn cookieName nicht verwendet werden kann.

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