ドキュメント

Adobe Commerceの読み取り専用ルートディレクトリが原因で、Apple Pay ドメインの検証が失敗する

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

Managed ServicesのAdobe Commerceでは、ルートレベルの .well-known ディレクトリが制限され、書き込み可能ではないため、Apple Pay ドメインの検証が失敗します。 これを修正するには、書き込み可能なディレクトリに検証ファイルをホストし、.magento.app.yaml ファイルまたは Fastly VCL スニペットを使用してルーティングを設定します。

説明 description

環境

  • 製品：Managed ServicesのAdobe Commerce
  • バージョン：2.4.x
  • 影響を受ける環境：実稼動、ステージング

問題/症状

  • ルートディレクトリに書き込めないため、Apple Pay ドメインを検証できません。
  • ルートディレクトリは読み取り専用です。
  • Appleの要件に従い、301 リダイレクトは許可されません。

解決策 resolution

必要なファイルを正常に配置し、Apple Pay ドメインの検証用に設定するには、次の手順に従います。

  1. .well-known の下に /pub/media/ ディレクトリを作成します。
  2. Apple Pay から apple-developer-merchantid-domain-association.txt ファイルをダウンロードします。
  3. /pub/media/.well-known/ にファイルをアップロードします。

次に、以下のいずれかの方法を使用してルーティングを設定します。

方法 1:.magento.app.yaml の使用

  • .magento.app.yaml ファイルに次の設定を追加します。

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

  • 変更を自分の環境にプッシュします。

方法 2:Fastly VCL スニペットの使用

  • Magento管理者にログインし、 ストア に移動します。 > 設定 > 詳細 > システム

  • 「 フルページキャッシュ 」を展開し、「Fastly 設定 」に移動します >   カスタム VCL スニペット 。

  • 「 作成 」をクリックして、次のルールを追加します。

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

  • Apple_domain_association のようなわかりやすい名前を使用します。

  • タイプを recv に、優先度を 100 に設定します。

  • 作成 をクリックし、Fastly VCL をアップロード をクリックして変更を適用します。

これで、次の場所からファイルにアクセスできるようになります。
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

関連資料

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