管理员设置 - 嵌入

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

通过管理菜单中平台部分的嵌入页面，您可以为嵌入式 Looker 内容配置设置。

嵌入网域许可名单

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

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

Looker 登录页面的同源保护

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

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

在某些用例中，即使父页面与 Looker 实例的域名不兼容，您也必须允许 Looker 登录页面显示在 Looker iframe 中。在这些情况下，您需要将 Look-Login Pages 的 Same-Origin Protections 选项设置为 Disabled：

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

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

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

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

嵌入 SSO 身份验证

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

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

除非停用，否则通过嵌入式信息中心（通过提醒或定期发送）发送的电子邮件中都会包含一个链接，其中显示“查看完整信息中心”字样。借助此链接，电子邮件收件人可以连接到其 Looker 实例，并进一步探索电子邮件中传送的数据。

借助提醒和时间安排自定义网址选项，您可以在提醒和定时发送的电子邮件中配置自定义网址，该网址将嵌入用户与嵌入应用（而非 Looker 实例）相关联。

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

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

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

如果将此字段留空，系统将无法使用自定义链接，因为用户将无法在时间表或提醒对话框中选择网域。

选择内容路径

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

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

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

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

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

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

  注意 ：Slug 是一个随机选择的短字符串，用作在网址中使用的 Content ID 值的替代值。在前面的示例中，CQ1fu99Z9Y1ggq2wcHDfMm 是信息中心 Slug。您可以从信息中心的三点状菜单中选择获取链接，查看信息中心的 Slug。

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

网址标签

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

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

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

将此选项设置为已停用，即可隐藏嵌入式外观中的滤镜值。

选择更新以保存设置。

移除 Look 导航

借助移除“探索”导航功能，管理员可以进一步自定义嵌入的内容，尤其是嵌入的“探索”和信息中心。

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

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

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

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

将此选项设为停用，以保留对外观的引用以及嵌入式探索中的另存为外观和保存并安排选项。

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

当移除 Look 导航处于已启用状态时，系统将移除从嵌入式探索中对 Look 的引用和导航选项，以及嵌入的与 Look 关联的信息中心图块。

当移除 Look 导航处于停用状态时，嵌入用户可以在 Look 关联的图块的三点状图块操作菜单中选择查看 Look。

信息中心嵌入内容导航

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

嵌入内容管理

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

不使用 Cookie 的嵌入式功能

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

重要提示：您还必须在管理 > 身份验证 > 会话面板中启用永久会话设置，才能使用无 Cookie 嵌入。

嵌入 JWT 密钥

注意：当嵌入式 SSO 身份验证选项处于启用状态且无 Cookie 嵌入选项处于启用状态时，系统会显示此设置。

您需要使用 JSON Web 令牌 (JWT) Secret 才能使用无 Cookie 嵌入功能。无 Cookie 嵌入需要启用 Embed SSO 身份验证，但无 Cookie 嵌入会使用 Embed JWT Secret 而非 Embed Secret。

通过此选项，您可以设置或重置嵌入 JWT Secret。不需设置 JWT 密钥，因为第一次尝试创建无 Cookie 嵌入会话时将创建 JWT 令牌。与嵌入密钥不同，嵌入 JWT 密钥绝不会公开，因为它仅由 Looker 服务器在内部使用。

重置 JWT 令牌会使所有无 Cookie 嵌入会话失效。

嵌入密钥

注意：只有在嵌入 SSO 身份验证设置为启用时，系统才会显示此设置。

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

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

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

如需更改 Secret，请选择 Reset Secret（重置 Secret）按钮；但请注意，这会破坏所有现有的已签名嵌入。

嵌入 URI 验证器

注意：只有在设置了嵌入 Secret 后，此设置才会显示。

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

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