对于 AI 代理:可在 https://www.mongodb.com/zh-cn/docs/llms.txt 获取文档索引—通过在任何 URL 路径后添加 .md 可获取所有页面的 Markdown 版本。
Docs 菜单

嵌入通过 Google 登录进行身份验证的图表

本教程向您展示如何配置示例应用程序以在网页上呈现经过 Google 验证的嵌入式图表。

Users must sign in with their Google account to view the chart. 如果用户未使用 Google 登录,则 Charts 不会呈现经过身份验证的图表视图。

启用经过身份验证的嵌入以生成 Charts 基本 URL 和图表 ID。 您需要 Charts 基本 URL 和图表 ID 才能在网页上显示图表。

1

Dashboards 页面中,选择包含要嵌入的图表的仪表盘。有关导航到仪表盘的说明,请参阅仪表盘

2

在仪表盘中,单击以访问其嵌入信息。 从下拉菜单中选择Embed chart

注意

如果图表位于已启用嵌入功能的仪表盘上,则会自动启用Embed Chart选项。因此无法在已启用嵌入功能的仪表盘中为图表选择Embed chart选项。

3

如果您已对此图表使用的数据源启用外部共享,请跳过此步骤。 如果您尚未在数据源上启用嵌入,现在可以执行此操作。 单击Configure external sharing链接。

4
嵌入经过身份验证的图表
点击放大
5
6

您可以指定一个函数,为每个查看图表的用户注入 MongoDB 筛选器文档。 这对于呈现特定于用户的Atlas Charts非常有用。

例子

以下筛选器函数仅呈现文档的ownerId字段与嵌入式身份验证提供程序的令牌的sub字段的值匹配的数据:

function getFilter(context) {
return { ownerId: context.token.sub };
}

提示

要了解有关为每个用户注入筛选器的更多信息,请参阅注入特定于用户的筛选器。

7

指定图表查看器可以筛选数据的字段。默认情况下,不指定任何字段,这意味着在您明确允许至少一个字段之前,无法筛选图表。

提示

要了解有关可筛选字段的更多信息,请参阅指定可筛选字段。

8

在应用程序代码中使用这些值以及嵌入式身份验证提供者属性来嵌入图表。

创建 Google API 控制台项目以生成 Google 客户端 ID。 您需要 Google 客户端 ID 来配置 Charts 以使用 Google 登录。

要创建 Google API控制台项目,请参阅将 Google 登录集成到您的 Web应用中。

1

如果尚未显示Atlas Charts,请单击Atlas 用户界面侧边栏中 Services 标题下的 Visualization

Atlas 发布关联到项目的 Charts 实例。

2

单击Visualization侧边栏中Services标题下的Embedded Visualizations

显示“嵌入式可视化”页面。

3

注意

您必须是项目所有者才能访问权限Authentication Settings页面。 作为非管理员用户,您仍然可以使用嵌入式图表,但必须从项目所有者那里获取密钥。

单击 Authentication Settings 标签页。

显示“身份验证设置”标签页。

4
  1. Authentication providers部分中,单击Add

  2. Name字段中,输入提供商的描述性名称。

  3. Provider列表中选择Google

  4. Google Client Id字段中,输入您创建的 Google 客户端 ID。

  5. 单击 Save(连接)。

MongoDB 提供了一个预构建的示例应用程序,该应用程序演示了如何使用嵌入式 SDK,通过 Google 身份验证来显示嵌入式图表。

要运行示例应用,请从Github克隆Atlas Charts嵌入示例 - Google 身份验证存储库,然后按照Readme 文件中的说明开始使用该应用。您可以使用示例图表按原样运行应用,也可以对其进行自定义以使用现有图表。

您需要编辑的所有行都标有包含~REPLACE~的注释。

1

文件index.html位于authenticated-google项目的根目录中。

2

将现有的 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 API 控制台项目后,您的 Google 客户端 ID 可见。 有关创建 Google 客户端 ID的说明,请参阅创建 Google 客户端 ID。

3

将现有的baseUrl替换为要显示的图表的基本 URL。

const sdk = new ChartsEmbedSDK({
baseUrl: "https://charts-dev.mongodb.com/charts-exampleproject-fjotk", // Optional: ~REPLACE~ with your Charts URL
getUserToken: () => id_token
});

您的 Charts 基本 URL 将显示在嵌入选项模式窗口中。 有关启用图表嵌入功能的详细说明,请参阅嵌入 SDK

4

将现有的chartId替换为要显示的图表的 ID。

const chart = sdk.createChart({
chartId: "example-acaf-4af0-8320-5099bfebd1bd", // Optional: ~REPLACE~ with your Chart ID
});

您的图表 ID 显示在“嵌入选项”模式窗口中。 有关启用图表嵌入功能的详细说明,请参阅嵌入 SDK

完成应用自定义后,就可以运行了。