Documentation

La vérification du domaine Apple Pay échoue en raison du répertoire racine en lecture seule dans Adobe Commerce

Last update: Mon Oct 06 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Dans Adobe Commerce on Managed Services, la vérification du domaine Apple Pay échoue, car le répertoire .well-known de niveau racine est restreint et non accessible en écriture. Pour corriger ce problème, hébergez le fichier de vérification dans un répertoire accessible en écriture et configurez le routage à l’aide du fichier .magento.app.yaml ou des fragments de code VCL Fastly.

Description description

Environnement

  • Produit : Adobe Commerce sur Managed Services
  • Version : 2.4.x
  • Environnement affecté : production, évaluation

Problème/Symptômes

  • Impossible de vérifier le domaine Apple Pay en raison de l’impossibilité d’écrire dans le répertoire racine.
  • Le répertoire racine est en lecture seule.
  • Les redirections 301 ne sont pas autorisées conformément aux exigences d’Apple.

Résolution resolution

Pour placer correctement le fichier requis et le configurer pour la vérification du domaine Apple Pay, procédez comme suit :

  1. Créez un répertoire .well-known sous /pub/media/.
  2. Téléchargez le fichier apple-developer-merchantid-domain-association.txt à partir d’Apple Pay.
  3. Chargez le fichier dans /pub/media/.well-known/.

Configurez ensuite le routage à l’aide de l’une des méthodes suivantes :

Méthode 1 : Utilisation de .magento.app.yaml

  • Ajoutez la configuration suivante à votre fichier .magento.app.yaml :

    code language-none 
    "/.well-known":
  root: "pub/media/.well-known"
  allow: true
  scripts: false
  expires: 1y

  • Envoyez les modifications à votre environnement.

Méthode 2 : Utilisation de fragments de code VCL Fastly

  • Connectez-vous à Magento Admin et accédez à : Stores > Configurations > AVANCÉ > Système

  • Développez Cache de page complet, puis accédez à Configuration rapide >   Fragments de code VCL personnalisés.

  • Cliquez sur Créer, puis ajoutez la règle suivante :

    code language-none 
    if (req.url.path == "/.well-known/apple-app-site-association") {
  set req.url = "/media/.well-known/apple-app-site-association";
}

  • Utilisez un nom convivial comme Apple_domain_association.

  • Définissez le type sur recv et la priorité sur 100.

  • Cliquez sur Créer, puis sur Télécharger rapidement VCL pour appliquer les modifications.

Vous devriez maintenant pouvoir accéder au fichier à l’adresse :
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

Lecture connexe

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f