AEM에서 GraphQL 엔드포인트 관리 graphql-aem-endpoint

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

  • GraphQL 스키마에 액세스,
  • GraphQL 쿼리 보내기,
  • (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 엔드포인트 활성화하기 enabling-graphql-endpoint

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

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

해당 끝점을 활성화하려면 다음을 수행하십시오.

  1. 도구, 에셋 ​으로 이동한 다음 GraphQL ​을 선택합니다.

  2. 만들기 ​를 선택합니다.

  3. 새 GraphQL 엔드포인트 만들기 대화 상자가 열립니다. 여기에서 다음을 지정할 수 있습니다.

    • 이름: 엔드포인트의 이름입니다. 어떤 텍스트든 입력할 수 있습니다.
    • 다음에서 제공하는 GraphQL 스키마 사용: 드롭다운을 사용하여 필요한 사이트/프로젝트를 선택합니다.
    note note
    NOTE
    대화 상자에는 다음과 같은 경고가 표시됩니다.
    • GraphQL 엔드포인트는 신중하게 관리하지 않을 경우 데이터 보안 및 성능 문제를 초래할 수 있습니다. 끝점을 만든 후 적절한 사용 권한을 설정하세요.
  4. 만들기 ​를 사용하여 확인합니다.

  5. 다음 단계 대화 상자는 보안 콘솔에 대한 직접 링크를 제공하므로 새로 생성된 엔드포인트에 적절한 권한이 있는지 확인할 수 있습니다.

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

GraphQL 엔드포인트 게시하기 publishing-graphql-endpoint

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

CAUTION
엔드포인트는 모든 사용자가 액세스할 수 있습니다.
게시 인스턴스에서 GraphQL 쿼리가 서버에 과부하를 줄 수 있으므로 보안 문제가 발생할 수 있습니다.
끝점에 사용 사례에 적합한 ACL을 설정합니다.
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2