설명서Experience Cloud KCS

AEM Cloud 및 AMS 환경의 CDN 도메인 리디렉션 및 라우팅 문제

마지막 업데이트: 2026년 6월 21일

Adobe Experience Manager(AEM)에서 지원되지 않는 구성 또는 필수 구성 요소 누락으로 인해 도메인이 올바르게 매핑되지 않거나 리디렉션이 실패할 경우 도메인 리디렉션 및 라우팅 문제가 발생합니다. 리디렉션 동작이 CDN, Dispatcher 또는 AEM과 같은 실행 레이어에 따라 달라지고, 와일드카드 도메인 지원 부족 및 필수 SSL 구성과 같은 제한 사항으로 인해 발생합니다. 이 문제를 해결하려면 올바른 리디렉션 메커니즘을 식별하고 AEM 런타임을 기반으로 도메인 등록, SSL 및 리디렉션 규칙을 구성합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • Adobe Managed Services (AMS)
  • Adobe Experience Manager(AEM) On-Premise

문제/증상

  • 도메인은 항상 의도한 페이지가 아닌 사이트 루트로 확인됩니다.
  • 잘못된 호스트 헤더 동작으로 인해 리디렉션이 발생하면 무한 루프가 발생합니다.
  • 도메인이 Cloud Manager에 등록되지 않았으므로 리디렉션이 트리거되지 않습니다.
  • 와일드카드 하위 도메인(*.example.com)을 추가할 수 없으며 트래픽이 실패합니다.
  • 잘못된 구성 구문으로 인해 CDN 파이프라인 배포가 실패합니다.

근본 원인

리디렉션 동작은 CDN, Dispatcher 또는 AEM과 같이 리디렉션이 실행되는 위치에 따라 다릅니다. AEM as a Cloud Service은 CDN 처리를 위해 명시적 도메인 등록과 유효한 SSL 인증서가 필요합니다. 와일드카드 도메인 매핑은 지원되지 않으며 리디렉션 규칙 또는 호스트 헤더를 잘못 구성하면 실패나 루프가 발생합니다.

해결 방법 resolution

다음 단계에 따라 올바른 도메인 기반 리디렉션 및 라우팅 동작을 구성하십시오.

  1. AEM이 요청을 처리하기 전에 리디렉션을 발생할지 또는 AEM에 도달한 후에 리디렉션을 발생해야 올바른 실행 계층을 결정할지 식별합니다.
  2. AEM as a Cloud Service의 도메인-경로 라우팅에 CDN 리디렉션을 사용합니다.
  3. Adobe Managed Services 또는 온프레미스 환경에 Dispatcher 또는 Apache 재작성 규칙을 사용합니다.
  4. 요구 사항에 AEM에서 지원하지 않는 동적 와일드카드 하위 도메인이 포함된 경우 외부 리디렉션 서비스를 사용하십시오.
  5. Edge Delivery Services을 사용할 때는 애플리케이션 계층에서 정확한 경로 일치만 지원되므로 호스트 수준 라우팅에 CDN 기반 리디렉션을 사용합니다.

AEM as a Cloud Service(AEMaaCS)용

  1. Cloud Manager을 열고 환경으로 이동한 다음 도메인 관리에 액세스하여 리디렉션에 필요한 모든 도메인을 추가합니다.
  2. www가 아닌 도메인을 포함하여 각 도메인에 대해 유효한 SSL 인증서를 업로드하고 구성합니다.
  3. 각 도메인이 유효한 인증서와 함께 활성 상태를 표시하는지 확인합니다.
  4. 저장소 루트에서 cdn.yaml 파일을 만들거나 업데이트하여 리디렉션 규칙을 정의합니다.
  5. 필수 상태 코드 및 대상 경로 또는 URL과 함께 호스트 기반 조건을 사용하여 리디렉션 규칙을 정의합니다.
  6. Cloud Manager 구성 파이프라인을 실행하여 CDN 규칙을 배포하고 해당 배포가 성공적으로 완료되는지 확인합니다.
  7. 파이프라인 로그를 검토하고 규칙 구조를 수정하여 구성 파일의 구문 오류를 수정합니다.
  8. 해당되는 경우 지원되는 일치 조건을 사용하여 패턴 기반 리디렉션을 구성합니다.
  9. CDN 규칙에서 와일드카드 호스트 이름은 지원되지 않으므로 사용하지 마십시오.

Adobe Managed Services(AMS) 또는 온-프레미스용

  1. Dispatcher 또는 Apache 구성 파일에 재작성 규칙을 추가하여 도메인 수준 리디렉션을 구현합니다.
  2. 적절한 라우팅을 사용할 수 있도록 각 도메인 또는 하위 도메인에 대한 가상 호스트 항목을 구성합니다.
  3. 각 도메인 또는 하위 도메인을 적절한 AEM 사이트 루트에 매핑합니다.
  4. 가상 호스트 구성이 올바른 도메인 확인 및 우선 순위를 허용하는지 확인합니다.

Edge Delivery Services(EDS)용

애플리케이션 수준에서 정확한 경로 일치에 대해서만 리디렉션을 구성하고 CDN 계층에서 호스트 기반 리디렉션을 처리합니다.

유효성 검사:

  1. curl과 같은 도구를 사용하여 HTTP 요청을 실행하고 응답에 올바른 리디렉션 상태 및 위치 헤더가 포함되어 있는지 확인합니다.
  2. CDN 로그 또는 배포 결과를 확인하여 리디렉션 규칙이 올바르게 실행되는지 확인합니다.
  3. 요청 간 일관된 호스트 및 전달된 호스트 비헤이비어를 확인하여 리디렉션 루프가 발생하지 않는지 확인합니다.

에스컬레이션 시기:

  • 올바른 리디렉션 메커니즘을 구현한 후 리디렉션 동작이 예상 로직과 일치하지 않습니다.
  • 확인되지 않은 유효성 검사 또는 구문 오류로 인해 CDN 구성 배포에 실패합니다.
  • 적절한 등록 및 유효한 SSL 인증서에도 불구하고 도메인이 라우팅되지 않습니다.
  • 호스트 헤더 불일치로 인해 리디렉션 루프가 지속됩니다.
  • 와일드카드 또는 동적 도메인 라우팅 요구 사항은 지원되는 AEM 기능을 사용하여 구현할 수 없습니다.

관련 읽기

recommendation-more-help
experience-cloud-kcs-help-kbarticles