Beheben von Fehlern vom Typ „Nicht autorisierte Bereinigung“ für die CDN-Cache-Bereinigung in AEM as a Cloud Service

Letzte Aktualisierung: 21. Oktober 2026

In diesem Artikel wird erläutert, wie Sie die Nicht autorisierte Bereinigung“ beheben können. Bitte einen PURGE-Schlüssel über die Konfigurations-Pipeline einrichten. Fehler, der beim Löschen des CDN-Cache in Adobe Experience Manager as a Cloud Service auftritt. Die Lösung umfasst die Überprüfung und Korrektur der Struktur der CDN-Konfigurationsdatei und die Einrichtung des Bereinigungsschlüssels.

Beschreibung description

Umgebung

Adobe Experience Manager as a Cloud Service (AEMaaCS) (beliebiger Umgebungstyp)

Symptome

CDN-Bereinigungsanfragen (z. B. über cURL) schlagen mit einer -Antwort fehl, die etwa wie folgt lautet:

{ "status": "error", "reason": "Unauthorized Purge. Please setup a PURGE key via Configuration Pipeline." }
Die Konfigurations-Pipeline wird erfolgreich abgeschlossen und die Bereinigungsschlüssel sind als Umgebungsvariablen vorhanden.
Das Problem betrifft je nach Konfigurationsdateistruktur eine oder mehrere Umgebungen.

Ursache

Der häufigste Grund ist, dass die CDN-Konfigurationsdateien nicht nach der empfohlenen Struktur auf Umgebungsebene organisiert sind oder doppelte oder widersprüchliche Variablendefinitionen vorhanden sind. Daher wird der Bereinigungsauthentifizierer nicht angewendet, und Bereinigungsanfragen werden als nicht autorisiert zurückgewiesen.

Lösung resolution

Gehen Sie wie folgt vor, um das Problem zu beheben:

Überprüfen Sie die Struktur der CDN-Konfigurationsdatei in Ihrem Code-Repository:
- Stellen Sie sicher, dass CDN-Konfigurationsdateien gemäß der von Adobe empfohlenen Struktur auf Umgebungsebene organisiert sind. Verwenden Sie beispielsweise eine flache Struktur mit einer Datei pro Umgebung, z. B. cdn-stage.yaml für Staging und cdn-prod.yaml für die Produktion, wobei jede die entsprechende envTypes angibt.
- Vermeiden Sie es, CDN-Konfigurationsdateien in Unterordnern zu platzieren, die nicht von Cloud Manager auf Umgebungseinstellungen geprüft werden.
- Entfernen Sie alle doppelten oder widersprüchlichen CDN-Konfigurationsdateien, die für dieselbe Umgebung gelten können.
Aktivieren Sie die Zuweisung der geheimen Schlüsselvariablen bereinigen :
- Stellen Sie sicher, dass die Bereinigungsschlüsselgeheimnisse (z. B.: CDN_PURGEKEY_PRIMARY, CDN_PURGEKEY_SECONDARY oder umgebungsspezifische Entsprechungen) als Umgebungsvariablen konfiguriert sind, bevor Sie die Konfigurations-Pipeline ausführen.
- Stellen Sie sicher, dass das Feld Service Applied für diese geheimen Daten auf Alle und nicht auf einen bestimmten Dienst beschränkt ist.
Doppelte Variablendefinitionen entfernen:
- Konfigurieren Sie nicht dieselbe Variable sowohl als Pipeline-Variable als auch als Umgebungsvariable. Verwenden Sie für jede Variable nur eine Methode.
- Wenn umgebungsspezifische Variablen erforderlich sind, behalten Sie nur die Umgebungsvariablen bei und entfernen Sie die Pipeline-Variablen (oder umgekehrt, falls nicht erforderlich).
Stellen Sie die Konfiguration mithilfe der Cloud Manager-Konfigurations-Pipeline erneut bereit.
- Warten Sie, bis die Bereitstellung erfolgreich abgeschlossen wurde.

Validieren der Bereinigungsfunktion:

Wiederholen Sie die CDN-Bereinigungsanfrage mit dem richtigen Bereinigungsschlüssel in der X-AEM-Purge-Key.
Beispiel für curl-Befehl:

code language-none
`curl -X PURGE "https:///content/..." \ -H "X-AEM-Purge-Key: " \ -H "X-AEM-Purge: soft"`

Bestätigen Sie, dass die Antwort erfolgreich ist (zum Beispiel: { "status": "ok" }).