설명서Experience Cloud KCS

X-AEM-Edge-Key 잘못된 구성으로 인해 CDN 트래픽 오류가 발생합니다.

마지막 업데이트: 2026년 7월 28일

X-AEM-Edge-Key가 올바르게 구성되지 않으면 고객 관리 CDN을 통해 라우팅된 트래픽이 실패하거나 거부됩니다. 키를 생성하고, Cloud Manager에서 구성하고, cdn.yaml에서 참조한 다음 배포하여 트래픽 흐름을 복원하고 파이프라인 오류를 방지합니다.

설명 description

환경

  • Adobe Experience Manager as a Cloud Service
  • Adobe Developer App Builder

문제/증상

  • CDN 트래픽은 Adobe CDN에 의해 차단되거나 거부됩니다.
  • X-AEM-Edge-Key 헤더 누락으로 인해 요청이 실패했습니다.
  • 환경 암호가 누락되어 구성 파이프라인에 오류가 발생했습니다.
  • 셀프서비스가 필요하기 때문에 Edge 키에 대한 요청이 거절됩니다.

원인

X-AEM-Edge-Key가 생성되지 않거나 Cloud Manager 암호로 저장되지 않거나 구성에서 잘못 참조되거나 CDN에서 전송되지 않아 인증 오류가 발생합니다.

해결 방법 resolution

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

  1. 다음과 같은 명령을 사용하여 보안 키를 생성합니다.

    code language-none 
    openssl rand -hex 32

  2. 생성된 키로 Cloud Manager의 비밀 환경 변수를 만들고 유형을 비밀로 설정합니다.

  3. 저장소에서 구성 파일을 추가하거나 업데이트하고 암호를 참조합니다.

    code language-none 
    kind: "CDN"
version: "1"
metadata:
  envTypes:
    - "dev"
    - "stage"
    - "prod"
data:
  authentication:
    authenticators:
      - name: "edge-auth"
        type: "edge"
        edgeKey1: ${{CDN_EDGEKEY}}

  4. 구성 파이프라인을 실행하고 오류 없이 성공적으로 실행되었는지 확인합니다.

  5. 필요한 헤더를 보내도록 CDN을 구성합니다.

    • 게시 끝점으로 설정된 원본 도메인
    • 원본과 일치하는 호스트 헤더
    • 공개 도메인에 설정된 X-Forwarded-Host
    • 생성된 키로 설정된 X-AEM-Edge-Key

  6. CDN을 통해 사이트에 액세스하고 요청에 올바른 헤더가 포함되어 있는지 확인하여 트래픽의 유효성을 확인합니다.

관련 읽기

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