DocumentationExperience Cloud KCS

Résolution des erreurs « Purge non autorisée » pour la purge du cache du réseau CDN dans AEM as a Cloud Service

Dernière mise à jour : 21 octobre 2026

Cet article explique comment résoudre la Purge non autorisée. Configurez une clé PURGE via le pipeline de configuration. erreur qui se produit lors de la purge du cache CDN dans Adobe Experience Manager as a Cloud Service. La solution implique de vérifier et de corriger la structure de fichiers de configuration du réseau CDN et de purger la configuration des clés.

Description description

Environnement

Adobe Experience Manager as a Cloud Service (AEMaaCS) (tout type d’environnement)

Symptômes

  • Les requêtes de purge du réseau CDN (par exemple via curl) échouent avec une réponse similaire à :

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

  • Le pipeline de configuration se termine correctement et des clés de purge sont présentes en tant que variables d’environnement.

  • Le problème affecte un ou plusieurs environnements en fonction de la structure des fichiers de configuration.

Cause

La cause la plus courante est que les fichiers de configuration du réseau CDN ne sont pas organisés selon la structure recommandée au niveau de l’environnement ou qu’il existe des définitions de variable en double ou en conflit. Par conséquent, l’authentificateur de purge n’est pas appliqué et les demandes de purge sont rejetées car elles ne sont pas autorisées.

Résolution resolution

Suivez les étapes ci-dessous pour résoudre le problème :

  1. Examinez la structure des fichiers de configuration du réseau CDN dans votre référentiel de code :

    • Assurez-vous que les fichiers de configuration du réseau CDN sont organisés selon la structure au niveau de l’environnement recommandée par Adobe. Par exemple, utilisez une structure plate avec un fichier par environnement, telle que cdn-stage.yaml pour l’évaluation et cdn-prod.yaml pour la production, chacun spécifiant la envTypes appropriée.

    • Évitez de placer des fichiers de configuration du réseau CDN dans des sous-dossiers qui ne sont pas évalués par Cloud Manager pour les paramètres au niveau de l’environnement.

    • Supprimez tous les fichiers de configuration de réseau CDN en double ou en conflit qui peuvent s’appliquer au même environnement.

  2. Vérifiez l’affectation de la variable secrète de la clé de purge :

    • Vérifiez que les secrets de la clé de purge (par exemple : CDN_PURGEKEY_PRIMARY, CDN_PURGEKEY_SECONDARY ou équivalents spécifiques à un environnement) sont configurés en tant que variables d’environnement avant d’exécuter le pipeline de configuration.

    • Assurez-vous que le champ Service Applied de ces secrets est défini sur Tous et ne se limite pas à un service spécifique.

  3. Supprimez les définitions de variable en double :

    • Ne configurez pas la même variable à la fois comme variable de pipeline et comme variable d’environnement. Utilisez une seule méthode pour chaque variable.

    • Si des variables spécifiques à un environnement sont requises, conservez uniquement les variables d’environnement et supprimez les variables de pipeline (ou vice versa, si ce n’est pas nécessaire).

  4. Redéployez la configuration à l’aide du pipeline de configuration Cloud Manager.

    • Attendez que le déploiement soit terminé.

  5. Validez la fonctionnalité de purge :

    • Réessayez la requête de purge du réseau CDN à l’aide de la clé de purge correcte dans l’en-tête X-AEM-Purge-Key.

    • Exemple de commande curl :

    code language-none 
    curl -X PURGE "https:///content/..." \
-H "X-AEM-Purge-Key: " \
-H "X-AEM-Purge: soft"
    • Vérifiez que la réponse a réussi (par exemple : { "status": "ok" }).

Lecture connexe

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