설명서Experience Cloud KCS

AEM Helix: JSON2HTML 구성에 대한 관리 API 토큰의 올바른 사용

마지막 업데이트: 2026년 8월 4일

이 문서에서는 Adobe Experience Manager(AEM) Helix 환경에서 JSON2HTML구성 요청을 인증하기 위해 올바른 관리 API 토큰을 가져오고 사용하는 방법에 대해 설명합니다.

설명 description

환경

Adobe Experience Manager(AEM) Helix(모든 버전)

문제/증상

API 끝점(예: https://json2html.adobeaem.workers.dev/config/<ORG>/<SITE>/<BRANCH>)을 통해 JSON2HTML을 구성하려고 하면 401 권한 없음 오류​이 발생합니다. 요청에서 필수 인증 형식을 사용하지 않으면 인증이 실패합니다.

HTTP/1.1 401 Unauthorized

요청이 잘못된 헤더 또는 토큰 형식으로 전송되었습니다.

해결 방법 resolution

다음 단계에 따라 문제를 해결하십시오.

  1. https://admin.hlx.page/login​(으)로 이동하여 자격 증명을 인증합니다.

  2. 로그인한 후 https://admin.hlx.page/profile을(를) 엽니다.

  3. 브라우저 개발자 도구에서 admin.hlx.page에 대한 쿠키로 이동합니다.

  4. auth_token 쿠키의 값을 복사합니다.

  5. 권한 부여 머리글 서식 지정:

    • 헤더 이름: Authorization
    • 헤더 값: token <auth_token>(<auth_token>을(를) 쿠키 값으로 바꾸기)

cURL 명령 예:

curl -i -X POST \
    "https://json2html.adobeaem.workers.dev/config/<ORG>/<SITE>/<BRANCH>" \
    -H "Authorization: token <auth_token_from_cookie>" \
    -H "Content-Type: application/json" \
    --data '[  ... ] '

요청이 성공하면 HTTP/1.1 200 OK이(가) 반환되고 구성이 허용됩니다.

관련 읽기

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