Dokumentation

Die Verifizierung der Pay-Domain von Apple schlägt aufgrund des schreibgeschützten Stammverzeichnisses in Adobe Commerce fehl

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

In Adobe Commerce auf Managed Services schlägt die Verifizierung der Pay-Domain in Apple fehl, da das .well-known auf der Stammebene eingeschränkt und nicht beschreibbar ist. Um dies zu beheben, hosten Sie die Verifizierungsdatei in einem beschreibbaren Verzeichnis und konfigurieren Sie das Routing entweder mit der .magento.app.yaml-Datei oder den Fastly-VCL-Snippets.

Beschreibung description

Umgebung

  • Produkt: Adobe Commerce auf Managed Services
  • Version: 2.4.x
  • Betroffene Umgebung: Produktion, Staging

Problem/Symptome

  • Die Pay-Domain von Apple kann nicht verifiziert werden, da nicht in das Stammverzeichnis geschrieben werden kann.
  • Das Stammverzeichnis ist schreibgeschützt.
  • 301 Weiterleitungen sind gemäß den Anforderungen von Apple nicht zulässig.

Auflösung resolution

Gehen Sie wie folgt vor, um die erforderliche Datei erfolgreich zu platzieren und für die Apple-Pay-Domain-Verifizierung zu konfigurieren:

  1. Erstellen Sie ein .well-known Verzeichnis unter /pub/media/.
  2. Laden Sie die apple-developer-merchantid-domain-association.txt von Apple Pay herunter.
  3. Laden Sie die Datei in /pub/media/.well-known/ hoch.

Konfigurieren Sie dann das Routing mit einer der folgenden Methoden:

Methode 1: Verwenden von .magento.app.yaml

  • Fügen Sie folgende Konfiguration zu Ihrer .magento.app.yaml hinzu:

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

  • Übertragen Sie die Änderungen in Ihre Umgebung.

Methode 2: Verwendung von Fastly VCL-Snippets

  • Melden Sie sich bei Magento Admin an und gehen Sie zu: Stores > Konfigurationen > ERWEITERT > System

  • Erweitern Sie Vollständiger Seitencache und gehen Sie dann zu Fastly-Konfiguration >   Benutzerdefinierte VCL-Snippets.

  • Klicken Sie Erstellen und fügen Sie die folgende Regel hinzu:

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

  • Verwenden Sie einen benutzerfreundlichen Namen wie Apple_domain_association.

  • Legen Sie den Typ auf recv und die Priorität auf 100 fest.

  • Klicken Sie Erstellen und anschließend auf Fastly VCL hochladen, um die Änderungen anzuwenden.

Sie sollten jetzt in der Lage sein, auf die Datei unter zuzugreifen:
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

Verwandtes Lesen

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