이 튜토리얼에서는 웹 페이지에 내장된 Google 인증 차트를 렌더링하도록 샘플 애플리케이션을 구성하는 방법을 보여줍니다.
차트를 보려면 사용자가 Google 계정으로 로그인해야 합니다. 사용자가 Google에 로그인하지 않으면 Charts는 인증된 차트 보기를 렌더링하지 않습니다.
전제 조건
연결된 인스턴스에 대한 임베딩 인증 제공자를 Atlas 구성하려면 프로젝트 소유자 Charts 여야 합니다.
절차
차트에 인증된 임베딩 활성화
인증된 임베딩을 활성화하여 Atlas Charts 기본 URL과 차트 ID를 생성합니다. 웹 페이지에 차트를 표시하려면 차트 기본 URL과 차트 ID가 필요합니다.
(선택 사항) 사용자별로 삽입할 필터하다 함수를 지정합니다.
차트를 보는 각 사용자에게 MongoDB 필터 문서를 삽입하는 함수를 지정할 수 있습니다. 이는 사용자별 Atlas Charts를 렌더링할 때 유용합니다.
예시
다음 필터 함수는 문서의 ownerId
필드가 임베딩 인증 제공자의 토큰의 sub
필드 값과 일치하는 데이터만 렌더링합니다.
function getFilter(context) { return { ownerId: context.token.sub }; }
팁
사용자별 필터를 삽입하는 방법에 대해 자세히 알아보려면 사용자별 필터 삽입을 참조하세요.
(선택 사항) 차트 에 대해 필터링 가능한 필드를지정합니다.
차트 뷰어에서 데이터를 필터링할 수 있는 필드를 지정합니다. 기본적으로 필드는 지정되지 않으므로, 하나 이상의 필드를 명시적으로 허용할 때까지 차트를 필터링할 수 없습니다.
팁
필터링 가능한 필드에 대해 자세히 알아보려면 필터링 가능한 필드 지정을 참조하세요.
Google 클라이언트 ID 만들기
Google API 콘솔 프로젝트를 생성하여 Google 클라이언트 ID를 생성합니다. Google 로그인을 사용하려면 Charts를 구성하려면 Google Client ID가 필요합니다.
Google API 콘솔 프로젝트 만들려면 웹 앱 에 Google 로그인 통합하기를 참조하세요.
Google 로그인을 사용하도록 Charts 구성
Embedding 페이지로 이동합니다.
사이드바의 Development 제목 아래에 있는 Embedding 을 클릭합니다.
임베딩 페이지가 표시됩니다.
차트를 표시하는 웹 앱 만들기
MongoDB는 Embedding SDK로 Google 인증을 통해 임베딩된 차트를 표시하는 방법을 보여주는 사전 빌드된 예제 앱을 제공합니다.
예시 앱 실행 하려면 Github 에서 Atlas Charts Embedding Example-Google Authentication 리포지토리 복제하고 Readme
파일 의 지침에 따라 앱 사용을 시작합니다. 샘플 차트 사용하여 앱 을 있는 그대로 실행 하거나 기존 차트 사용하도록 사용자 지정할 수 있습니다.
Node.js 앱 사용자 지정
편집해야 하는 모든 줄은 ~REPLACE~
이 포함된 주석으로 표시되어 있습니다.
Google 클라이언트 ID 입력
기존 Google 클라이언트 ID를 Google 클라이언트 ID로 바꿉니다.
<!-- Optional: ~REPLACE~ content with your Google Client ID --> <meta name="google-signin-client_id" content="012345678910-ifpoccch8js9srh9obfdn683h1iss2ag.apps.googleusercontent.com" />
Google 클라이언트 ID는 Google API 콘솔 프로젝트를 만든 후에 볼 수 있습니다. Google 클라이언트 ID 만들기에 대한 지침 은 Google 클라이언트 ID 만들기를 참조하세요.
Charts 기본 URL 입력
기존 baseUrl
를 표시하려는 차트의 기본 URL로 바꿉니다.
const sdk = new ChartsEmbedSDK({ baseUrl: "https://charts-dev.mongodb.com/charts-exampleproject-fjotk", // Optional: ~REPLACE~ with your Charts URL getUserToken: () => id_token });
Your Charts 기본 URL은 임베딩 옵션 모달 창에서 볼 수 있습니다. 차트 임베딩을 활성화하는 방법에 대한 자세한 지침은 임베딩 SDK 를 참조하세요.
차트 ID 입력
기존 chartId
를 표시하려는 차트의 ID로 바꿉니다.
const chart = sdk.createChart({ chartId: "example-acaf-4af0-8320-5099bfebd1bd", // Optional: ~REPLACE~ with your Chart ID });
차트 ID는 임베딩 옵션 모달 창에서 볼 수 있습니다. 차트 임베딩을 활성화하는 방법에 대한 자세한 지침은 임베딩 SDK 를 참조하세요.
앱 사용자 지정이 완료되면 앱을 실행할 준비가 된 것입니다.