管理员设置 - 嵌入

注意： 如果您使用的是 Looker (Google Cloud Core) 实例，则只有在使用 Looker (Google Cloud Core) 的 嵌入版时，才会看到此页面。

您可以在管理员 菜单的平台 部分中找到嵌入 页面，并在此页面中配置嵌入式 Looker 内容的设置。

注意 ：如果您拥有仅提供对管理面板中特定页面的访问权限的权限（例如 manage_schedules、manage_themes 或 see_admin），但没有 管理员角色，则此处介绍的页面可能不会显示在管理面板中。

嵌入网域许可名单

您需要使用此设置，才能利用 JavaScript 事件 在父页面和 Looker iframe 之间传递数据或操作。

在这种情况下，请将使用 iframe 的网域添加到此字段，然后选择更新 。

**重要提示**： 请勿在网域网址中添加尾部斜杠 (/)。

Looker 登录页面的同源保护

对于 Looker 登录页面，您可以使用 Looker 登录页面的同源保护 设置来指明是否要允许跨源嵌入：

• 已停用：Looker 允许跨源嵌入。
• 已启用：Looker 不允许跨源嵌入。

在某些用例中，即使父页面与 Looker 实例的域名不兼容，您也必须允许 Looker 登录页面显示在 Looker iframe 中。在这些情况下，您需要将 Looker 登录页面的同源保护 选项设置为 已停用：

• 如果您在非 Looker 网域托管的网页的 iframe 中使用 Looker 内容的私密嵌入，则需要停用Looker 登录页面的同源保护，以便 Looker 可以在 iframe 中显示登录页面并允许用户登录 Looker。

如果满足以下任一条件，请将 Looker 登录页面的同源保护 设置为已启用 ：

• 您不嵌入任何 Looker 内容。
• 您仅使用 签名嵌入，因为 Looker 登录页面不用于签名嵌入。

如需更改同源保护的设置，请使用下拉菜单选择您选择的选项，然后务必选择更新 按钮以保存您的选择。

嵌入单点登录身份验证

如果您想使用 Looker 的 签名嵌入 功能，则需要启用 嵌入单点登录身份验证 功能。如需启用此功能，请选择已启用 ，然后选择更新 。

提醒和时间安排自定义网址

除非停用，否则来自嵌入式信息中心的电子邮件递送（无论是来自提醒还是安排的递送）都包含一个链接，其中显示查看完整信息中心。借助此链接，电子邮件收件人可以连接到其 Looker 实例，并进一步探索电子邮件中递送的数据。

借助提醒和时间安排自定义网址 选项，您可以在提醒和定时发送的邮件递送中配置自定义网址，该网址会将嵌入用户链接到嵌入应用，而不是 Looker 实例。

**注意**： 嵌入应用负责对点击链接以返回自定义网址的任何用户进行身份验证和验证。

嵌入时间表和提醒许可名单的网域

指定电子邮件递送中的自定义网址可能会链接到的所有网域。此处列出的网域将填充时间安排和提醒对话框中的网域 字段。

如果此字段留空，则自定义链接不可用，因为在时间安排或提醒对话框中，用户将无法选择任何网域。

选择内容路径

通过此下拉菜单，您可以选择自定义链接中网址的格式。它具有以下选项：

• 仅嵌入网域 \- 自定义链接中的网址仅包含在时间安排或提醒对话框的网域 字段中选择的网域。例如，app.customer.com。

• 用户定义的网址 \- 自定义链接中的网址包含在时间安排或提醒对话框的网域 字段中选择的网域，以及用户在时间安排或提醒对话框的路径 字段中输入的路径。例如，app.customer.com/my_embed_app。

• 在网域网址中嵌入 Looker ID \- 自定义链接中的网址将包含在时间安排或提醒对话框的网域 字段中选择的网域，以及使用内容 ID 的嵌入式信息中心的 Looker 路径。例如，app.customer.com/dashboards/12。

  注意 ：即使选择了此选项，启用了特定许可功能的实例也会使用信息中心处理后标题添加 Looker 路径。如果发生这种情况，并且您想在自定义链接网址中使用信息中心 ID，请提交支持请求。

• 在网域网址中嵌入 Looker 处理后标题 \- 自定义链接中的网址包含在时间安排或提醒对话框的网域 字段中选择的网域，以及使用内容处理后标题的嵌入式信息中心的 Looker 路径。例如，app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm。

  注意 ：处理后标题是随机选择的短字符串，用作网址中内容 ID 值的替代值。在前面的示例中，CQ1fu99Z9Y1ggq2wcHDfMm 是信息中心处理后标题。您可以通过从信息中心的三点状菜单中选择获取链接来查看信息中心处理后标题。三点状菜单

如果嵌入时间表和提醒许可名单的网域 字段留空，则选择内容路径 不可用。

网址标签

使用此字段输入新的默认链接文本，该文本将替换电子邮件递送中的文本查看完整信息中心。您可以在时间安排和提醒对话框中更改默认文本。

在嵌入式 Look 中显示过滤条件

如果您想在嵌入式 Look 中显示过滤条件值，请将此选项设置为已启用 。

将此选项设置为已停用 可隐藏嵌入式 Look 中的过滤条件值。

选择更新 以保存您的设置。

移除 Look 导航

借助移除 Look 导航 功能，管理员可以进一步自定义嵌入式内容，特别是嵌入式探索和嵌入式信息中心。

从嵌入式探索中移除 Look 导航

默认情况下，拥有 explore 和 save_content 权限 的嵌入用户会在嵌入式探索的 探索操作 齿轮菜单 中看到以下选项：

• 另存为 Look 选项
• 保存并安排 选项（适用于拥有发送或安排 权限的嵌入用户）

如果设置为已启用，移除 Look 导航功能会从嵌入式探索的探索操作齿轮菜单中移除对 Look 的所有引用，包括另存为 Look和保存并安排选项。

将该选项设置为已停用 ，以便在嵌入式探索中保留对 Look 的引用以及另存为 Look 和保存并安排 选项。

从嵌入式信息中心移除 Look 导航

如果 移除 Look 导航 设置为已启用 ，系统会从嵌入式探索和嵌入式 Look 关联的信息中心板块中移除对 Look 的引用和导航选项。

如果移除 Look 导航设置为已停用，嵌入用户将可以选择在 Look 关联的板块的三点状板块操作菜单中查看 Look。

信息中心嵌入内容导航

启用此选项后，已获得必要 权限 的嵌入式信息中心查看者可以 从嵌入式信息中心查看文件夹以及其中包含的 Look 和信息中心。如需让嵌入式信息中心的查看者能够复制、移动和删除信息中心，您必须启用此功能。

嵌入内容管理

启用此选项后，已获得必要权限的嵌入式信息中心查看者可以复制、移动和删除信息中心。

不使用 Cookie 的嵌入式功能

从 Looker 23.8 开始，获取不使用 Cookie 的会话时可以包含嵌入网域。这是使用 Looker 管理员 > 嵌入面板添加嵌入网域的替代方法。Looker 会将嵌入网域保存在 Looker 内部数据库中，因此不会显示在管理员 面板的嵌入 页面上。相反，嵌入网域与不使用 Cookie 的会话相关联，并且仅在该会话期间存在。如果您决定利用此功能，请查看安全最佳实践。

**重要提示**： 您还必须启用“持久会话”设置（位于“管理员”>“身份验证”>“会话”面板中），才能使用不使用 Cookie 的嵌入式功能。

嵌入 JWT 密钥

**注意**： 当**嵌入单点登录身份验证** 选项设置为**已启用** 且**不使用 Cookie 的嵌入式功能** 选项已启用时，系统会显示此设置。

您需要 JSON 网络令牌 (JWT) 密钥才能使用不使用 Cookie 的嵌入式功能。不使用 Cookie 的嵌入式功能要求启用嵌入单点登录身份验证 ，但不使用 Cookie 的嵌入式功能使用嵌入 JWT 密钥 而不是嵌入密钥 。

借助此选项，您可以设置或重置嵌入 JWT 密钥。设置 JWT 密钥不是必需的，因为首次尝试创建不使用 Cookie 的嵌入式会话时，系统会创建 JWT 令牌。 与嵌入密钥不同，嵌入 JWT 密钥永远不会公开，因为它仅供 Looker 服务器在内部使用。

重置 JWT 令牌会使所有当前不使用 Cookie 的嵌入式会话失效。

嵌入密钥

**注意**： 只有当**嵌入单点登录身份验证** 设置为**已启用** 时，系统才会显示此设置。

您需要嵌入密钥才能使用 Looker 的 签名嵌入 功能。

如需检索嵌入密钥，请选择设置密钥 按钮。

**注意**：请务必立即复制密钥并将其保存在安全的位置，因为离开此页面后，您将无法从此页面检索密钥。

如需更改密钥，请选择重置密钥 按钮，但您应该知道，这会破坏任何现有的签名嵌入。

嵌入 URI 验证器

**注意**： 只有在设置了**嵌入密钥** 后，系统才会显示此设置。

为 Looker 的 签名嵌入 功能生成网址后，您可以将该网址粘贴到 嵌入 URI 验证器 字段中，然后点击 测试 URI 来测试该网址。URI 验证器将返回一条消息，指明签名嵌入网址是否有效。

输入签名嵌入网址后，嵌入 URI 快速检查 部分将显示签名嵌入网址中包含的参数和值。