자체 범용 편집기 서비스 실행

마지막 업데이트: 2025년 2월 6일

작성 대상:

  • 관리자
  • 개발자

로컬 개발을 위해 또는 자체 인프라의 일부로 고유한 범용 편집기 서비스를 실행하는 방법에 대해 알아봅니다.

개요

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

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

사용 사례

범용 편집기 서비스의 사용자 복사본은 다음 경우에 유용합니다.

  • 범용 편집기에서 사용할 AEM을 로컬로 개발합니다.
  • Adobe의 Universal Editor Service와 관계없이 자체 인프라의 일부로 Universal Editor Service를 실행하십시오.

두 사용 사례가 모두 지원됩니다. 이 문서에서는 범용 편집기 서비스의 로컬 복사본과 함께 HTTPS로 AEM을 실행하는 방법을 설명합니다.

자체 인프라의 일부로 범용 편집기 서비스를 실행하려는 경우 로컬 개발 예와 동일한 단계를 따릅니다.

HTTPS에서 실행할 AEM 설정

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

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

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

Universal Editor Service 설치

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

NodeJS 버전 20은(는) 유니버설 편집기 서비스의 로컬 복사본을 실행해야 합니다.

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

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

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

또한 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를 로컬에서 실행하려면 NodeJS에서 여러 환경 변수를 설정해야 합니다.

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

UES_PORT=8000
UES_PRIVATE_KEY=./key.pem
UES_CERT=./certificate.pem
UES_TLS_REJECT_UNAUTHORIZED=false
UES_CORS_PRIVATE_NETWORK=true

이 예제에서 로컬 개발에 필요한 최소값은 다음과 같습니다.

NOTE
Chrome 버전 130 이상을 실행 중인 경우 UES_CORS_PRIVATE_NETWORK 옵션을 사용하여 개인 네트워크 액세스에 대한 CORS 헤더 전송을 활성화해야 합니다.

다음 표에서는 이러한 값과 사용 가능한 추가 값에 대해 자세히 설명합니다.

값옵션기본값설명
UES_PORT예8080서버가 실행되는 포트
UES_PRIVATE_KEY예없음HTTPS 서버의 개인 키 경로
UES_CERT예없음HTTPS 서버의 인증 파일 경로
UES_TLS_REJECT_UNAUTHORIZED예true승인되지 않은 TLS 연결 거부
UES_DISABLE_IMS_VALIDATION예falseIMS 유효성 검사 비활성화
UES_ENDPOINT_MAPPING예비어 있음내부 재작성에 대한 끝점의 매핑
예: UES_ENDPOINT_MAPPING='[{"https://your-public-facing-author-domain.net": "http://10.0.0.1:4502"}]'
결과: Universal Editor Service가 제공된 연결 https://your-public-facing-author-domain.net 대신 http://10.0.0.1:4502에 연결합니다.
UES_LOG_LEVEL예info서버의 로그 수준입니다. 가능한 값은 silly, trace, debug, verbose, info, log, warn, error 및 fatal입니다.
UES_SPLUNK_HEC_URL예없음Splunk 끝점에 대한 HEC URL
UES_SPLUNK_TOKEN예없음Splunk 토큰
UES_SPLUNK_INDEX예없음로그를 기록할 인덱스
UES_SPLUNK_SOURCE예universal-editor-servicesplunk 로그의 소스 이름
UES_CORS_PRIVATE_NETWORK예false개인 네트워크를 허용하도록 CORS 헤더 전송을 활성화하십시오. Chrome 버전 130+ 사용자에 필요
NOTE
유니버설 편집기의 2024.08.13 릴리스 이전에는 .env 파일에 다음 변수가 필요했습니다. 이러한 값은 이전 버전과의 호환성을 위해 2024년 10월 1일까지 지원됩니다.
EXPRESS_PORT=8000
EXPRESS_PRIVATE_KEY=./key.pem
EXPRESS_CERT=./certificate.pem
NODE_TLS_REJECT_UNAUTHORIZED=0

Universal Editor Service 실행

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

$ node ./universal-editor-service.cjs

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

Universal Editor Service listening on port 8000 as HTTPS Server

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

글로벌 서비스 대신 로컬 Universal Editor Service 사용

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를 사용하여 페이지 편집

로컬에서 실행되는 범용 편집기 서비스와(과) 로컬 서비스를 사용하도록 계측된 콘텐츠 페이지를 사용하면 이제 편집기를 시작할 수 있습니다.

  1. 브라우저를 열고 https://localhost:8000/ping으로 이동합니다.
  2. 브라우저에서 자체 서명된 인증서를 수락하도록 지시합니다.
  3. 자체 서명된 인증서를 신뢰하는 경우 로컬 Universal Editor Service를 사용하여 페이지를 편집할 수 있습니다.

Experience Manager