모듈 탐색, 활성화 및 비활성화

Gato GraphQL의 모든 기능은 모듈을 통해 제공됩니다. 플러그인 메뉴에서 「Modules」를 클릭하여 접근할 수 있습니다.

각 모듈은 활성화 또는 비활성화할 수 있습니다. 그 상태는 테이블에서 확인할 수 있습니다.

활성화된 모듈은 색상 배경으로 표시됩니다
비활성화된 모듈은 흰색 배경으로 표시됩니다

모듈 활성화/비활성화

비활성화된 모듈의 이름 위에 마우스를 올리면 "Enable" 링크가 표시됩니다. 클릭하면 모듈이 활성화됩니다.

모듈 활성화

마찬가지로, 활성화된 모듈의 이름 위에 마우스를 올리면 "Disable" 링크가 표시됩니다. 클릭하면 모듈이 비활성화됩니다.

일괄 처리

또한, 각 모듈의 체크박스를 선택한 후 「Bulk actions」 드롭다운에서 "Enable" 또는 "Disable"을 선택하는 방법도 있습니다.

모듈 일괄 비활성화

공개 및 비공개 엔드포인트에서의 모듈 비활성화

모듈을 비활성화하면 GraphQL 서버에서 일부 기능(예: single endpoint)을 제거하거나, GraphQL 스키마에서 일부 요소(예: 타입, 필드, 디렉티브)를 제거할 수 있습니다.

「스키마 모듈(Schema modules)」이란 GraphQL 스키마에 타입·필드·디렉티브를 추가하는 모듈을 말합니다(Modules 페이지의 「Schema Type」 및 「Schema Directive」 카테고리에서 찾을 수 있습니다). 불필요한 「스키마 모듈」을 모두 비활성화하면 GraphQL API의 보안을 강화할 수 있습니다. 소비되어서는 안 되는 데이터는 처음부터 노출되지 않습니다.

예를 들어, 「Users」 모듈을 비활성화하면 사용자 필드(QueryRoot.users, Post.author 등)가 GraphQL 스키마에서 제거됩니다.

따라서, 엔드포인트의 비활성화(이전 섹션에서 설명)는 항상 공개 엔드포인트에 적용됩니다.

Single endpoint
Custom endpoints
Persisted queries

그러나 「스키마 모듈」에 대한 접근을 방문자(즉, 공개 엔드포인트)에게만 제한하고, 내부 작업 실행 시 전체 GraphQL 스키마 접근을 제한하지 않도록 사이트 관리자의 비공개 엔드포인트에는 제한을 적용하지 않을 수도 있습니다.

비공개 엔드포인트는 다음과 같습니다.

엔드포인트 wp-admin/edit.php?page=graphql_api&action=run_query(관리자의 GraphiQL 및 Interactive Schema 클라이언트를 구동하며, WordPress 편집기에서 블록에 데이터를 공급하기 위해 호출할 수 있습니다)
커스텀 비공개 엔드포인트(블록에 데이터를 공급하는 데도 사용되지만, PHP 훅을 통해 구성을 잠글 수 있습니다)
내부적으로 실행되는 GraphQL 쿼리(PHP의 클래스 GraphQLServer 사용)

「스키마 모듈」을 비공개 엔드포인트에서도 비활성화하려면, 설정 페이지의 「Plugin Configuration > Private Endpoints」 탭에서 「Disable "Schema modules" in the private endpoints?」 항목을 체크하여 설정해야 합니다.

모듈 일괄 비활성화