在「管理」選單的「平台」部分中,點選「嵌入」頁面,即可設定嵌入 Looker 內容的設定。
嵌入網域許可清單
您必須使用這項設定,才能利用 JavaScript 事件,在父項頁面和 Looker iframe 之間傳遞資料或動作。
在這種情況下,請在這個欄位中新增使用 iframe 的網域,然後選取「更新」。
Looker 登入頁面的同源保護措施
針對 Looker 登入頁面,您可以使用「Looker 登入頁面的同源保護措施」設定,指出是否允許跨來源嵌入:
- 已停用:Looker 允許跨來源嵌入。
- 已啟用:Looker 不允許跨來源嵌入。
在某些用途中,即使父頁面與 Looker 執行個體的網域名稱不相容,您仍必須允許 Looker 登入頁面顯示在 Looker iframe 中。在下列情況下,您必須將「Looker 登入頁面的同源保護措施」選項設為「停用」:
- 如果您在非 Looker 網域代管的網頁 iframe 中使用 Looker 內容的私人嵌入功能,就必須停用 Looker 登入頁面的同源保護措施,讓 Looker 在 iframe 中顯示登入頁面,並允許使用者登入 Looker。
如果符合下列任一條件,請將「Looker 登入頁面的同源保護措施」設為「已啟用」:
- 您未嵌入任何 Looker 內容。
- 您只會使用已簽署的嵌入功能,因為 Looker 登入頁面不會用於已簽署的嵌入功能。
如要變更同源保護設定,請使用下拉式選單選取所需選項,然後務必選取「更新」按鈕,儲存所選項目。
嵌入單一登入 (SSO) 驗證
如要使用 Looker 的已簽署嵌入功能,必須啟用嵌入單一登入 (SSO) 驗證功能。如要啟用,請依序選取「Enabled」和「Update」。
快訊和排程功能的自訂網址
除非停用,否則嵌入式資訊主頁的電子郵件傳送作業 (無論是警報還是排定傳送) 都會附上「View full dashboard」連結。只要按一下該連結,電子郵件收件者就能連線至自己的 Looker 執行個體,並進一步查看電子郵件中提供的資料。
您可以透過「警告和排程功能的自訂網址」選項,在警告和排程電子郵件中設定自訂網址,將嵌入使用者連結至嵌入應用程式,而非 Looker 例項。
嵌入排程和警告許可清單的網域
請指定電子郵件中自訂網址可能連結到的所有網域。系統會在排程和警示對話方塊的「網域」 欄位中填入此處列出的網域。
如果這個欄位留空,使用者就無法在排程或快訊對話方塊中選取網域,因此無法使用自訂連結。
選取內容路徑
這個下拉式選單可讓您選取自訂連結中的網址格式。此參數提供以下選項:
僅限嵌入網域:自訂連結中的網址只包含排程或快訊對話方塊中「網域」欄位所選的網域。例如:
app.customer.com
。使用者定義的網址:自訂連結中的網址包含排程或快訊對話方塊中「網域」欄位所選的網域,以及使用者在排程或快訊對話方塊中的「路徑」欄位中輸入的路徑。例如:
app.customer.com/my_embed_app
。嵌入含 Looker ID 的網域網址:自訂連結中的網址會包含在排程或快訊對話方塊的「網域」欄位中選取的網域,以及使用內容 ID 的嵌入儀表板 Looker 路徑。例如:
app.customer.com/dashboards/12
。嵌入含 Looker 動態資料欄位的網域網址:自訂連結中的網址包含排程或快訊對話方塊中「網域」欄位所選的網域,以及使用內容動態資料欄位的嵌入儀表板 Looker 路徑。例如:
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm
。
如果「嵌入排程和警告許可清單的網域」欄位留空,就無法使用「選取內容路徑」選項。
網址標籤
請在這個欄位中輸入新的預設連結文字,以取代電子郵件中「View full dashboard」文字。您可以在排程和快訊對話方塊中變更預設文字。
顯示嵌入式 Look 圖表的篩選器
如要顯示嵌入式外觀中的篩選器值,請將這個選項設為「已啟用」。
將這個選項設為「Disabled」,即可隱藏嵌入式 Look 中的篩選器值。
選取「更新」即可儲存設定。
移除 Look 導覽
移除 Look 導覽功能可讓管理員進一步自訂內嵌內容,特別是內嵌的「探索」和資訊主頁。
從嵌入的探索中移除 Look 導覽
根據預設,具備 explore
和 save_content
權限的嵌入使用者,會在嵌入的 Explore 的 「探索動作」齒輪選單中看到下列選項:
- 「儲存為 Look」選項
- 「儲存並排程」選項 (適用於擁有傳送或排程權限的嵌入使用者)
設定為「已啟用」時,「移除 Look 導覽」功能會從嵌入式 Explore 的「探索動作」齒輪選單中,移除所有 Look 參照,包括「儲存為 Look」和「儲存並排程」選項。
將選項設為「停用」,即可保留 Look 參照,以及嵌入式探索中「儲存為 Look」和「儲存並排程」選項。
從嵌入式資訊主頁中移除 Look 導覽
當「移除 Look 導覽」功能啟用時,系統會移除 嵌入的探索和嵌入的Look 連結資訊主頁圖塊的 Look 參照和導覽選項。
當「移除 Look 導覽」功能停用時,嵌入的使用者可以在 Look 連結資訊方塊的三點「資訊方塊操作」選單中,選擇「查看 Look」。
資訊主頁嵌入內容導覽
啟用這個選項後,已取得必要權限的嵌入式資訊主頁檢視者,就能在嵌入式資訊主頁中查看資料夾和其中包含的 Look 和資訊主頁。您必須啟用這項功能,才能讓嵌入式資訊主頁的觀看者複製、移動及刪除資訊主頁。
嵌入內容管理
啟用這項選項後,已獲授必要權限的嵌入式資訊主頁檢視者,就能複製、移動及刪除資訊主頁。
無 Cookie 嵌入
從 Looker 23.8 開始,在取得無 Cookie 工作階段時,可以納入嵌入網域。這是使用 Looker 管理員 > 嵌入面板新增嵌入網域的替代方法。Looker 會將內嵌網域儲存在 Looker 內部資料庫中,因此不會顯示在「管理」面板的「嵌入」頁面中。相反地,嵌入網域會與無 Cookie 工作階段建立關聯,並只在工作階段期間存在。如果您決定使用這項功能,請參閱安全性最佳做法。
嵌入 JWT 密鑰
您必須使用 JSON Web Token (JWT) 密鑰,才能使用無 Cookie 嵌入功能。無 Cookie 嵌入功能需要啟用「嵌入 SSO 驗證」,但無 Cookie 嵌入功能會使用「嵌入 JWT 密鑰」,而非「嵌入密鑰」。
這個選項可讓您設定或重設內嵌 JWT 密鑰。設定 JWT 密鑰並非必要,因為首次嘗試建立無 Cookie 嵌入工作階段時,系統就會建立 JWT 權杖。與嵌入密鑰不同,嵌入 JWT 密鑰不會公開,因為只有 Looker 伺服器會在內部使用。
重設 JWT 權杖後,所有有效的無 Cookie 嵌入工作階段都會失效。
嵌入密鑰
您必須使用嵌入密鑰,才能使用 Looker 的已簽署嵌入功能。
如要擷取嵌入密鑰,請選取「Set Secret」(設定密鑰) 按鈕。
如要變更密鑰,請選取「重設密鑰」按鈕,但請注意,這麼做會導致任何已簽署的嵌入項目失效。
嵌入 URI 驗證工具
為 Looker 的已簽署嵌入功能產生網址後,您可以將網址貼到「Embed URI Validator」欄位,然後點選「Test URI」來測試網址。URI 驗證工具會傳回訊息,指出已簽署的嵌入網址是否有效。
輸入已簽署的嵌入網址後,「Embed URI quick check」部分會顯示已簽署嵌入網址中包含的參數和值。