설명서

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 관리자에 로그인하고 스토어(으)로 이동합니다. > 구성 > 고급 > 시스템

  • 전체 페이지 캐시 를 확장한 다음 빠른 구성 >(으)로 이동   사용자 지정 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(으)로 설정합니다.

  • 만들기 를 클릭한 다음 가장 빠른 VCL 업로드 를 클릭하여 변경 내용을 적용합니다.

이제 다음 위치에 있는 파일에 액세스할 수 있습니다.
https://your_domain/.well-known/apple-developer-merchantid-domain-association.txt

관련 읽기

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