AEMaaCS에서 CDN 라우팅 및 헤더 문제 해결

잘못된 원본 설정, 필수 헤더 누락 또는 잘못 구성된 라우팅 규칙으로 인해 AEMaaCS의 사용자 지정 CDN 구성이 실패합니다. AEM은 항상 Adobe 관리 Fastly를 통해 트래픽을 라우팅하므로 요청을 수락하려면 올바른 호스트 이름 타깃팅 및 특정 헤더가 필요합니다. 구성이 잘못되면 라우팅 실패, SSL 불일치, 421 또는 알 수 없는 도메인​과 같은 오류가 발생합니다. 원본 구성, 헤더 전달 및 cdn.yaml 라우팅을 수정하여 문제를 해결하고 적절한 요청 흐름을 복원하십시오.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service (AEMaaCS)
  • AEM Managed Services
  • Adobe Developer App Builder

문제/증상

  • AEM에 대한 요청이 실패하고 Fastly 421 또는 알 수 없는 도메인 오류가 발생합니다.
  • 고객 CDN이 게시 끝점에 도달할 수 없습니다.
  • 라우팅 실패 또는 SSL 불일치가 발생합니다.
  • 캐싱 불일치가 나타납니다.
  • 필요한 헤더를 제거하거나 덮어쓸 때 헤더 기반 인증이 실패합니다.

근본 원인

AEM as a Cloud Service은 게시 계층에 도달하기 전에 Fastly를 통해 모든 트래픽을 라우팅합니다. 고객 CDN의 요청은 올바른 게시 호스트 이름을 타깃팅하는 동안 Host, SNI 및 X-AEM-Edge-Key와 같은 필수 헤더를 포함해야 합니다. 누락되거나 잘못된 구성으로 인해 요청이 빠르게 거부되거나 라우팅 오류가 발생합니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. Cloud Manager 환경에서 게시 호스트 이름을 식별하고, 403 또는 유사한 응답을 반환하는 브라우저에서 URL을 직접 로드하여 확인합니다. 정확한 게시 호스트 이름을 가리키도록 CDN 또는 WAF 원본을 구성하고 SSL 핸드셰이크가 성공하도록 호스트 헤더, SNI, 프로토콜 HTTPS 및 포트 443​을(를) 설정합니다.
  2. Fastly가 요청을 신뢰할 수 있는 것으로 인식하도록 X-AEM-Edge-Key, X-Forwarded-Host, X-Forwarded-ProtoX-Forwarded-For을(를) 구성하여 CDN에서 Fastly로 필수 헤더를 전달한 다음 로그 및 curl 테스트를 사용하여 헤더 전달을 확인합니다.
  3. 사용자 지정 라우팅이 필요한 경우 /config 아래의 Cloud Manager Git 저장소에 cdn.yaml 파일을 커밋하고 원본 선택기 규칙을 추가한 다음 구성 파이프라인을 실행하여 성공적으로 배포합니다.
  4. cdn.yaml 요청 변환 규칙을 사용하여 지역 헤더 삽입을 구성하여 기존 Adobe 지역 헤더(예: x-aem-client-country, x-aem-client-continent)를 사용자 지정 헤더(예: X-Forwarded-Country, X-Forwarded-Region)에 매핑하고 헤더 검사를 통해 변환을 확인합니다.
  5. 공용 도메인을 고객 CDN으로 지정하고 CDN 타겟을 Fastly와 AEM으로 확인하여 DNS 흐름을 검증합니다. 이로써 사용자 정의 도메인에 대해 Fastly에 직접 DNS를 매핑하지 않아도 됩니다.
  6. Fastly가 항상 고객 CDN과 AEM 사이에 있으며 제거하거나 우회할 수 없는지 확인한 다음, 공개 도메인을 통해 사이트에 액세스하고 브라우저 개발자 도구를 사용하여 라우팅, 헤더 및 캐싱 동작을 확인하여 엔드 투 엔드 유효성 검사를 수행합니다.

관련 읽기

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