설명서Experience Cloud KCS

AEM as a Cloud Service: 인증 토큰으로 인한 JSON2HTML 작업자 구성 끝점에 대한 401 승인되지 않은 오류

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

이 문서에서는 Adobe Experience Manager as a Cloud Service의 Edge Delivery Services에 대한 JSON2HTML 작업자 구성 끝점에 액세스할 때 401 Unauthorized 오류를 해결하는 방법에 대해 설명합니다.

설명 description

환경


Adobe Experience Manager as a Cloud Service (모든 버전)

문제/증상


Edge Delivery Services용 Adobe 설명서에 설명된 대로 JSON2HTML 작업자 구성 끝점에 액세스하려고 하면 다음 오류가 발생합니다.

HTTP 401 Unauthorized
Authentication Token Required

표준 AEM 관리 API 토큰을 사용하려고 하면 동일한 오류가 발생합니다. 이 문제는 특히 AEM 콘텐츠 조각을 Edge Delivery Services에 게시 설명서의 4단계를 수행하고 다음과 유사한 URL에 액세스할 때 발생합니다.

https://json2html.adobeaem.workers.dev/config/<tenant>/<project>/<branch>
  • 끝점이 표준 AEM 관리 API 토큰을 허용하지 않습니다.
  • 오류 메시지는 인증 토큰이 필요함을 나타냅니다.
  • 요청에서 토큰에 대해 잘못된 헤더 키 또는 값 형식을 사용했을 수 있습니다.

해결 방법 resolution

  1. 올바른 인증 헤더를 사용하고 있는지 확인합니다.

    • 헤더 키는 Authorization이어야 합니다.
    • 값은 token <your-token> 형식이어야 합니다(<your-token>을(를) 실제 토큰 값으로 바꾸기).

  2. 표준 AEM 관리 API 토큰은 이 끝점에 유효하지 않으므로 사용하지 마십시오.

  3. JSON2HTML 작업자 구성 끝점에 대한 필수 토큰 가져오기:

    • 환경에 대한 올바른 토큰을 생성하거나 검색하는 방법에 대한 지침은 Edge Delivery Services의 공식 Adobe 설명서 JSON2HTML을(를) 참조하십시오.
    • 설명서가 명확하지 않거나 필요한 토큰에 액세스할 수 없는 경우 Adobe 관리자 또는 지원 담당자에게 지원을 요청하십시오.

  4. 올바른 Authorization 헤더 및 토큰 값을 포함하도록 API 요청을 업데이트합니다.

  5. 엔드포인트 액세스를 다시 시도하십시오. 문제가 지속되면 토큰이 만료되지 않았는지, 요청한 리소스에 대해 필요한 권한이 있는지 확인하십시오.

원인

끝점에 Authorization 헤더에 특정 인증 토큰이 필요하고 표준 AEM 관리 API 토큰이 허용되지 않으므로 401 Unauthorized 오류가 발생합니다.

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