AEM에서 GraphQL 엔드포인트 관리

마지막 업데이트: 2024년 9월 7일

작성 대상:

엔드포인트는 AEM용 GraphQL에 액세스하는 데 사용되는 경로입니다. 이 경로를 사용하여 사용자(또는 앱)는 다음과 같은 작업을 수행할 수 있습니다.

AEM에는 두 가지 유형의 엔드포인트가 있습니다.

전역
- 모든 사이트에서 사용할 수 있습니다.
- 이 엔드포인트는 모든 Sites 구성의 모든 콘텐츠 조각 모델을 사용할 수 있습니다(구성 브라우저에 정의됨).
- Sites 구성 간에 공유해야 하는 콘텐츠 조각 모델이 있는 경우 전역 Sites 구성에서 생성해야 합니다.
Sites 구성:
- 구성 브라우저에 정의된 Sites 구성에 해당합니다.
- 지정된 사이트/프로젝트에만 해당됩니다.
- Sites 구성 특정 엔드포인트는 해당 특정 Sites 구성의 콘텐츠 조각 모델을 전역 Sites 구성의 콘텐츠 조각 모델과 함께 사용합니다.

CAUTION

콘텐츠 조각 편집기는 한 Sites 구성의 콘텐츠 조각이 다른 Sites 구성의 콘텐츠 조각을 참조하도록 허용할 수 있습니다(정책을 통해).

이러한 경우, Sites 구성 특정 엔드포인트를 사용하여 모든 콘텐츠를 검색할 수 있는 것은 아닙니다.

콘텐츠 작성자가 이 시나리오를 제어해야 합니다. 예를 들어 공유 콘텐츠 조각 모델을 전역 Sites 구성 아래에 두는 것이 유용할 수 있습니다.

AEM용 GraphQL 전역 엔드포인트의 저장소 경로는 다음과 같습니다.

/content/cq:graphql/global/endpoint

앱이 요청 URL에서 다음 경로를 사용할 수 있는 경우:

/content/_cq_graphql/global/endpoint.json

AEM용 GraphQL의 엔드포인트를 활성화하려면 다음 작업을 수행해야 합니다.

GraphQL 엔드포인트 활성화하기

GraphQL 엔드포인트를 활성화하려면 먼저 적절한 구성이 필요합니다. 콘텐츠 조각 - 구성 브라우저를 참조하십시오.

CAUTION

콘텐츠 조각 모델 사용이 활성화되지 않은 경우 만들기 옵션을 사용할 수 없습니다.

해당 엔드포인트를 활성화하려면 다음 작업을 수행하십시오.

도구, 일반 으로 이동한 다음 GraphQL 을 선택합니다.
만들기 를 선택합니다.
새 GraphQL 엔드포인트 만들기 대화 상자가 열립니다. 여기에서 다음을 지정할 수 있습니다.
- 이름: 엔드포인트의 이름입니다. 어떤 텍스트든 입력할 수 있습니다.
- 다음에서 제공하는 GraphQL 스키마 사용: 드롭다운 목록을 사용하여 필요한 사이트/프로젝트를 선택합니다.
NOTE
다음 경고가 대화 상자에 표시됩니다.
GraphQL 엔드포인트는 신중하게 관리하지 않을 경우 데이터 보안 및 성능 문제를 초래할 수 있습니다. 엔드포인트를 만든 후 적절한 권한을 설정했는지 확인하십시오.
만들기 를 사용하여 확인합니다.
다음 단계 대화 상자는 보안 콘솔에 대한 직접 링크를 제공하므로 만든 엔드포인트에 적절한 권한이 있는지 확인할 수 있습니다.

CAUTION
엔드포인트는 모든 사용자가 액세스할 수 있습니다. 특히 게시 인스턴스에서 GraphQL 쿼리가 과도한 부하를 줄 수 있으므로 보안 문제가 발생할 수 있습니다.
엔드포인트에 사용 사례에 적합한 ACL을 설정할 수 있습니다.

새 엔드포인트를 선택하고 게시 를 선택하여 모든 환경에서 완전히 사용할 수 있도록 합니다.

CAUTION

엔드포인트는 모든 사용자가 액세스할 수 있습니다.

게시 인스턴스에서 GraphQL 쿼리가 서버에 과부하를 줄 수 있으므로 보안 문제가 발생할 수 있습니다.

엔드포인트에 사용 사례에 적합한 ACL을 설정합니다.