Documentazione

La verifica del dominio Apple Pay non riesce a causa della directory principale di sola lettura in Adobe Commerce

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

In Adobe Commerce su Managed Services, la verifica del dominio Apple Pay non riesce perché la directory principale .well-known è soggetta a restrizioni e non è scrivibile. Per risolvere il problema, ospitare il file di verifica in una directory scrivibile e configurare il routing utilizzando il file .magento.app.yaml o i snippet Fastly VCL.

Descrizione description

Ambiente

  • Prodotto: Adobe Commerce su Managed Services
  • Versione: 2.4.x
  • Ambiente interessato: produzione, staging

Problema/Sintomi

  • Impossibile verificare il dominio Apple Pay a causa dell’impossibilità di scrivere nella directory principale.
  • La directory principale è di sola lettura.
  • I reindirizzamenti 301 non sono consentiti in base ai requisiti di Apple.

Risoluzione resolution

Per inserire correttamente il file richiesto e configurarlo per la verifica del dominio Apple Pay, segui questi passaggi:

  1. Creare una directory .well-known in /pub/media/.
  2. Scarica il file apple-developer-merchantid-domain-association.txt da Apple Pay.
  3. Carica il file in /pub/media/.well-known/.

Quindi, configurare l'instradamento utilizzando uno dei metodi seguenti:

Metodo 1: utilizzo di .magento.app.yaml

  • Aggiungi la seguente configurazione al file .magento.app.yaml:

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

  • Invia le modifiche all’ambiente.

Metodo 2: utilizzo dei frammenti VCL Fastly

  • Accedi a Amministrazione Magento e vai a: Archivi > Configurazioni > AVANZATE > Sistema

  • Espandi Cache a pagina intera, quindi vai a Configurazione rapida >   Snippet VCL personalizzati.

  • Fai clic su Crea e aggiungi la seguente regola:

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

  • Utilizza un nome descrittivo come Apple_domain_association.

  • Impostare il tipo su recv e la priorità su 100.

  • Fai clic su Crea, quindi su Carica Fastly VCL per applicare le modifiche.

Ora dovresti essere in grado di accedere al file all’indirizzo:
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

Lettura correlata

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