설명서AEM as a Cloud Service사용 안내서

Universal Editor를 사용하는 로컬 AEM 개발 local-dev-ue

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • 관리자
  • 개발자

Universal Editor가 개발 목적으로 로컬 AEM 인스턴스 편집을 지원하는 방법에 대해 알아봅니다.

개요 overview

Universal Editor Service는 Universal Editor와 백엔드 시스템을 바인딩하는 서비스입니다. 범용 편집기에서 로컬로 개발하려면 범용 편집기 서비스의 로컬 복사본을 실행해야 합니다. 이유는 다음과 같습니다.

  • Adobe의 공식 범용 편집기 서비스는 전 세계적으로 호스팅되며 로컬 AEM 인스턴스를 인터넷에 노출해야 합니다.
  • 로컬 AEM SDK를 사용하여 개발하는 동안 인터넷에서 Adobe의 Universal Editor 서비스에 액세스할 수 없습니다.
  • AEM 인스턴스에 IP 제한이 있고 Adobe의 Universal Editor 서비스가 정의된 IP 범위에 있지 않은 경우 직접 호스팅할 수 있습니다.

이 문서에서는 범용 편집기에서 사용할 AEM을 AEM에서 로컬로 개발할 수 있도록 범용 편집기 서비스의 로컬 복사본과 함께 HTTPS로 를 실행하는 방법을 설명합니다.

HTTPS에서 실행할 AEM 설정 aem-https

HTTPS로 보호되는 외부 프레임 내에서 비보안 HTTP 프레임을 로드할 수 없습니다. Universal Editor Service가 HTTPS에서 실행되므로 AEM 또는 다른 원격 페이지도 HTTPS에서 실행되어야 합니다.

이를 위해 HTTPS에서 실행하려면 AEM을 설정해야 합니다. 개발 목적으로 자체 서명된 인증서를 사용할 수 있습니다.

사용할 수 있는 자체 서명된 인증서를 포함하여 HTTPS에서 실행되는 AEM을 설정하는 방법은 이 문서를 참조하십시오.

Universal Editor Service 설치 install-ue-service

범용 편집기 서비스는 범용 편집기의 전체 복사본이 아니라 로컬 AEM 환경의 호출이 인터넷을 통해 라우팅되지 않고 사용자가 제어하는 정의된 끝점에서 라우팅되도록 하는 기능의 하위 집합일 뿐입니다.

유니버설 편집기 서비스의 로컬 복사본을 실행하려면 NodeJS 버전 16이 필요합니다.

범용 편집기 서비스는 소프트웨어 배포를 통해 사용할 수 있습니다. 액세스 방법에 대한 자세한 내용은 소프트웨어 배포 설명서를 참조하세요.

소프트웨어 배포의 universal-editor-service.cjs 파일을 로컬 개발 환경에 저장합니다.

HTTPS를 사용하여 Universal Editor Service를 실행할 인증서 만들기 ue-https

또한 Universal Editor Service를 사용하려면 개발 환경의 HTTPS에서 실행할 인증서가 필요합니다.

다음 명령을 실행합니다.

$ openssl req -newkey rsa:2048 -nodes -keyout key.pem -x509 -days 365 -out certificate.pem

명령은 key.pem 및 certificate.pem 파일을 생성합니다. 이 파일을 universal-editor-service.cjs 파일과 같은 경로로 저장합니다.

Universal Editor Service 구성 설정 setting-up-service

Universal Editor Service를 로컬에서 실행하려면 NodeJS에서 여러 환경 변수를 설정해야 합니다.

universal-editor-service.cjs, key.pem 및 certificate.pem 파일과 같은 경로에서 다음 콘텐츠로 .env 파일을 만듭니다.

EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

변수의 의미는 다음과 같습니다.

Universal Editor Service 실행 running-ue

Universal Editor 서비스를 시작하려면 다음 명령을 실행합니다.

$ node ./universal-editor-service.cjs

터미널로 다음 항목이 출력되어야 합니다.

Universal Editor Service listening on port 8000 as HTTPS Server

서비스가 HTTP 서버가 아닌 HTTPS 서버를 시작하는지 확인합니다.

글로벌 서비스 대신 로컬 Universal Editor Service 사용 using-local-ue

Universal Editor는 페이지 구성 방식에 따라 페이지를 편집하는 데 사용할 Universal Editor Service를 인식합니다. 이는 Universal Editor에 로드된 페이지의 메타 태그를 통해 수행됩니다.

로컬 Universal Editor Service를 사용하여 페이지를 편집하려면 다음 메타 태그를 설정해야 합니다.

<meta name="urn:adobe:aue:config:service" content="https://localhost:8000">

설정되면 모든 콘텐츠 업데이트 호출이 기본 Universal Editor Service 대신 https://localhost:8000으로 이동하는 것을 확인할 수 있습니다.

NOTE
https://localhost:8000에 직접 액세스하려고 하면 404 오류가 발생합니다. 이는 예상되는 비헤이비어입니다.
로컬 유니버설 편집기 서비스에 액세스를 테스트하려면 https://localhost:8000/corslib/LATEST을(를) 사용하십시오. 자세한 내용은 다음 섹션을 참조하세요.
TIP
페이지를 구성하여 글로벌 Universal Editor Service를 사용하는 방법에 대한 자세한 내용은 AEM에서 Universal Editor 시작하기 문서를 참조하십시오.

로컬 Universal Editor Service를 사용하여 페이지 편집 editing

Universal Editor Service가 로컬에서 실행하고 콘텐츠 페이지를 구성하여 로컬 서비스를 사용하면 편집기를 시작할 수 있습니다.

  1. 브라우저를 열고 https://localhost:8000/corslib/LATEST으로 이동합니다.
  2. 자체 서명된 인증서를 허용하도록 브라우저를 내보냅니다.
  3. 자체 서명된 인증서를 신뢰하는 경우 로컬 Universal Editor Service를 사용하여 페이지를 편집할 수 있습니다.
recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab