DocumentationAEMGuide de l’utilisateur

Filtre Référent referrer-filter

Dernière mise à jour : 11 octobre 2026
  • S'applique à :
  • Experience Manager as a Cloud Service

Créé pour :

  • Administrateur ou administratrice
  • Développeur

Le filtre de référent d’Adobe Experience Manager autorise l’accès à partir d’hôtes tiers.

Une configuration OSGi pour le filtre de référent est nécessaire pour autoriser l’accès au point d’entrée GraphQL pour les applications découplées via POST HTTP. Lors de l’utilisation de requêtes persistantes découplées AEM qui accèdent à AEM via GET HTTP, aucune configuration de filtre de référent n’est nécessaire.

WARNING
Le filtre de référent AEM n’est pas une configuration d’usine OSGi, ce qui signifie qu’une seule configuration à la fois est active sur un service AEM. Dans la mesure du possible, évitez d’ajouter des configurations de filtre de référent personnalisées, car elles remplacent les configurations natives AEM et peuvent altérer la fonctionnalité du produit.

Pour ce faire, ajoutez une configuration OSGi appropriée pour le filtre Référent qui :

  • spécifie un nom d’hôte de site web approuvé ; soit allow.hosts, soit allow.hosts.regexp,
  • accorde l’accès pour ce nom d’hôte.

Le nom du fichier doit être org.apache.sling.security.impl.ReferrerFilter.cfg.json.

Exemple de configuration example-configuration

Par exemple, pour accorder l’accès aux requêtes avec le référent my.domain, vous pouvez :

CAUTION
Il s’agit d’un exemple de base qui peut remplacer la configuration standard. Vous devez vous assurer que les mises à jour des produits sont toujours appliquées aux personnalisations.
{
    "allow.empty": false,
    "allow.hosts": [
      "my.domain"
    ],
    "allow.hosts.regexp": [
      ""
    ],
    "filter.methods": [
      "POST",
      "PUT",
      "DELETE",
      "COPY",
      "MOVE"
    ],
    "exclude.agents.regexp": [
      ""
    ]
}

Sécurité des données data-security

CAUTION
Il vous incombe toujours d'aborder pleinement les points suivants.

Pour que vos données restent sécurisées, vous devez vous assurer que :

  • l’accès est uniquement accordé aux domaines approuvés

  • syntaxe de [*] des caractères génériques not utilisée ; cela désactive l’accès authentifié au point d’entrée GraphQL et l’expose au monde entier

  • les informations sensibles ne sont jamais exposées ; ni directement, ni indirectement :

    • Par exemple, tous les schémas 🔗 sont les suivants :

      • provenant des modèles de fragment de contenu qui ont été activés

      and

      • sont lisibles via le point d’entrée GraphQL.

      Cela signifie que les informations présentes sous forme de noms de champ dans la définition de modèle peuvent être disponibles.

Vous devez vous assurer qu’aucune donnée sensible n’est disponible, de sorte que ces détails doivent être soigneusement pris en compte.

recommendation-more-help
experience-manager-cloud-service-help-main-toc