本文档介绍了如何排查设置 Looker 嵌入功能时遇到的问题。如果嵌入的内容无法加载,请检查以下几个可能的原因。
决策树
使用以下决策树排查嵌入设置问题:
问题排查步骤
以下部分将更详细地介绍树中的场景。
这是已签名的嵌入吗?
如需详细了解签名嵌入,请参阅签名嵌入文档。
如果您使用的是签名嵌入,请继续阅读私密嵌入是否有效?。如果您未使用签名嵌入,请参阅第三方 Cookie 问题。
私密嵌入是否有效?
检查私密嵌入是否正常运行。
如果私密嵌入有效,请继续排查签名嵌入问题。如果私密嵌入不起作用,请参阅第三方 Cookie 问题。
第三方 Cookie 问题
检查嵌入平台的网域和嵌入网址的网域。如果基本网域不匹配,则可能是浏览器屏蔽了第三方 Cookie 导致了此问题。
例如,如果您的嵌入式应用托管在 example.com
上,但用于嵌入的 Looker 实例网址为 customer.cloud.looker.com
,则当 Looker iframe 嵌入到 example.com
中时,浏览器可能会阻止来自 customer.cloud.looker.com
的 Cookie。如果您的 Looker 实例位于 looker.example.com
,则由于基本网域 example.com
匹配,Cookie 将为第一方 Cookie。
如果问题是由拒绝第三方 Cookie 引起的,您可以启用浏览器中的第三方 Cookie,也可以配置自定义网域。对于 Looker (Google Cloud Core) 实例,您可以使用自助服务配置自定义网域。对于 Looker(原始)实例,您可以申请配置自定义网域,以便使实例网域与嵌入式应用的基本网域保持一致。
排查已签名的嵌入问题
如果您在签名嵌入方面遇到问题,请参阅以下问题排查页面:
- 如果您没有看到 Looker 界面,或者只看到登录页面,请参阅对已签名的嵌入式身份验证错误进行问题排查。
- 如果您看到 Looker 界面,但遇到 404 错误、权限问题或内容访问问题,请参阅排查已签名的嵌入式内容中的 404 错误、权限问题和内容访问问题。
最终审核和支持
如果嵌入式 iframe 仍无法加载,请查看本页上的问题排查步骤。如果您仍需要帮助,请先收集以下信息,然后再与支持团队联系: