Schutzmodi für gesperrte Assets

HINWEIS: Die Funktion „Gesperrte Assets“ ist nur für bestimmte Pakete verfügbar. Wenden Sie sich an Ihre Kontaktperson für den Vertrieb, um weitere Informationen zur Verfügbarkeit der Funktion zu erhalten.

In diesem Artikel werden die verschiedenen Möglichkeiten erläutert, wie Sie mit der Funktion „Gesperrte Assets“ Ihre Assets schützen können. Wenn Sie die Funktion aktivieren, können Sie einen der folgenden Schutzmodi auswählen:

  • Vorbereitungsmodus – Hier können Sie testen, ob Ihre Website mit gesperrten Assets funktionieren kann, während gleichzeitig der normale Website-Betrieb aufrechterhalten wird.

  • Unveröffentlichte Assets geschützt – Hier können Sie nur unveröffentlichte Assets schützen, während veröffentlichte Assets ohne Signaturen abgerufen werden.

  • Alle Assets geschützt – Hier können Sie sowohl unveröffentlichte als auch veröffentlichte Assets schützen.

HINWEIS: Standardmäßig sind gesperrte Assets deaktiviert. Die Content Delivery API (CDA), Content Management API (CMA) und Content Preview API (CPA) geben alle normale Asset-URLs zurück. Alle Assets in Ihrem Space können ohne Signaturen abgerufen werden.

Nachfolgend finden Sie eine detaillierte Erklärung der einzelnen Modi.

Vorbereitungsmodus

Dieser Modus ist für die Verwendung vorgesehen, wenn Sie einen vorhandenen Space auf die Verwendung von gesperrten Assets umstellen.

Wenn Sie den Vorbereitungsmodus für Ihren Space aktivieren, können Sie Asset-Schlüssel erstellen, gesperrte Asset-URLs signieren und Asset-Dateien von signierten URLs abrufen. Damit können Sie Ihre Website und Ihre Tools testen, um sicherzustellen, dass sie mit gesperrten Assets funktionieren.

Im Vorbereitungsmodus geben CDA, CMA und CPA weiterhin öffentliche Asset-URLs zurück. Diese Assets können wie gewohnt ohne Signaturen abgerufen werden und Ihre Website funktioniert weiterhin ohne Änderung.

Sobald Sie mit der Implementierung fertig sind und bereit sind, sichere Asset-URLs zu erzwingen, können Sie eine der folgenden Optionen auswählen.

Geschützter Modus für unveröffentlichte Assets

Wenn dieser Modus aktiviert ist, werden nur unveröffentlichte Assets geschützt.

Die CDA, die nur veröffentlichten Content zurückgibt, gibt öffentliche Asset-URLs zurück. Diese Assets können wie gewohnt ohne Signaturen abgerufen werden.

Die CMA und CPA geben stattdessen nicht signierte, gesperrte Asset-URLs zurück. Sie müssen diese URLs mit einem gültigen Asset-Schlüssel signieren, bevor sie abgerufen werden können. Wenn dieser Modus aktiviert ist, funktionieren alle öffentlichen Asset-URLs für unveröffentlichte Assets in Ihrem Space innerhalb von 48 Stunden nicht mehr.

Wichtig: Für die Zwecke von gesperrten Assets gilt ein bestimmtes Asset (wie durch seine ID bestimmt) als veröffentlicht, wenn es in einer beliebigen Umgebung in einem Space veröffentlicht wurde. Es ist wichtig, dies zu berücksichtigen, wenn Sie mehrere Umgebungen und/oder Umgebungsalias verwenden, um Content-Änderungen vorzubereiten und zu veröffentlichen.

Geschützter Modus für alle Assets

Wenn dieser Modus aktiviert ist, werden alle Assets, sowohl veröffentlichte als auch unveröffentlichte, geschützt.

Alle Contentful-APIs (CDA, CMA und CPA) geben nicht signierte, gesperrte Asset-URLs zurück. Sie müssen diese URLs mit einem gültigen Asset-Schlüssel signieren, bevor sie abgerufen werden können. Wenn dieser Modus aktiviert ist, funktionieren alle öffentlichen Asset-URLs für Assets in Ihrem Space innerhalb von 48 Stunden nicht mehr.