DocumentazioneExperience Cloud KCS

Risoluzione degli errori di “Eliminazione non autorizzata” per l’eliminazione della cache CDN in AEM as a Cloud Service

Ultimo aggiornamento: 21 ottobre 2026

In questo articolo viene illustrato come risolvere la rimozione non autorizzata di . Imposta una chiave PURGE tramite pipeline di configurazione.Errore durante l’eliminazione della cache CDN in Adobe Experience Manager as a Cloud Service. La soluzione prevede la revisione e la correzione della struttura del file di configurazione CDN e l’eliminazione della chiave di configurazione.

Descrizione description

Ambiente

Adobe Experience Manager as a Cloud Service (AEMaaCS) (qualsiasi tipo di ambiente)

Sintomi

  • Le richieste di eliminazione CDN (ad esempio tramite CURL) non riescono e restituiscono una risposta simile a:

    { "status": "error", "reason": "Unauthorized Purge. Please setup a PURGE key via Configuration Pipeline." }

  • La pipeline di configurazione viene completata correttamente e le chiavi di eliminazione sono presenti come variabili di ambiente.

  • Il problema riguarda uno o più ambienti a seconda della struttura del file di configurazione.

Causa

La causa più comune è che i file di configurazione CDN non sono organizzati in base alla struttura consigliata a livello di ambiente, oppure che sono presenti definizioni di variabili duplicate o in conflitto. Di conseguenza, l’autenticatore di eliminazione non viene applicato e le richieste di eliminazione vengono rifiutate in quanto non autorizzate.

Risoluzione resolution

Per risolvere il problema, segui i passaggi seguenti:

  1. Esamina la struttura del file di configurazione CDN nell’archivio del codice:

    • Assicurati che i file di configurazione CDN siano organizzati in base alla struttura consigliata a livello di ambiente di Adobe. Ad esempio, utilizza una struttura semplice con un file per ambiente, ad esempio cdn-stage.yaml per Staging e cdn-prod.yaml per Produzione, ciascuno specificando l’elemento envTypes appropriato.

    • Evita di inserire i file di configurazione CDN in sottocartelle che non sono valutate da Cloud Manager per le impostazioni a livello di ambiente.

    • Rimuovi eventuali file di configurazione CDN duplicati o in conflitto che possono essere applicati allo stesso ambiente.

  2. Controlla l’assegnazione della variabile segreta della chiave di rimozione:

    • Verificare che i segreti della chiave di eliminazione (ad esempio: CDN_PURGEKEY_PRIMARY, CDN_PURGEKEY_SECONDARY o equivalenti specifici dell’ambiente) siano configurati come variabili di ambiente prima di eseguire la pipeline di configurazione.

    • Verificare che il campo Service Applied per questi segreti sia impostato su Tutti e non sia limitato a un servizio specifico.

  3. Rimuovi le definizioni di variabili duplicate:

    • Non configurare la stessa variabile come variabile di pipeline o variabile di ambiente. Utilizza un solo metodo per ogni variabile.

    • Se sono necessarie variabili specifiche per l’ambiente, conserva solo le variabili di ambiente e rimuovi le variabili della pipeline (o viceversa, se non è necessaria).

  4. Ridistribuisci la configurazione utilizzando la pipeline di configurazione di Cloud Manager.

    • Attendere il completamento della distribuzione.

  5. Convalida funzionalità di eliminazione:

    • Riprovare la richiesta di eliminazione CDN utilizzando la chiave di eliminazione corretta nell’intestazione X-AEM-Purge-Key.

    • Esempio di comando curl:

    code language-none 
    curl -X PURGE "https:///content/..." \
-H "X-AEM-Purge-Key: " \
-H "X-AEM-Purge: soft"
    • Verificare che la risposta sia corretta, ad esempio { "status": "ok" }.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles