您可以在「管理」選單的「平台」部分,透過「嵌入」頁面設定嵌入式 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 的已簽署嵌入功能,請啟用「嵌入單一登入驗證」功能。如要啟用,請選取「已啟用」,然後選取「更新」。
快訊和排程功能的自訂網址
除非停用,否則透過快訊或排定傳送的內嵌資訊主頁電子郵件,都會附上「查看完整資訊主頁」連結。只要按一下該連結,電子郵件收件者就能連線至 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
。
如果「嵌入排程和警告許可清單的網域」欄位留空,「選取內容路徑」將無法使用。
網址標籤
使用這個欄位輸入新的預設連結文字,取代電子郵件中「查看完整資訊主頁」文字。您可以在排程和快訊對話方塊中變更預設文字。
顯示嵌入式 Look 的篩選器
如要在內嵌 Look 中顯示篩選器值,請將這個選項設為「已啟用」。
將這個選項設為「已停用」,即可在嵌入的 Look 中隱藏篩選器值。
選取「更新」即可儲存設定。
移除 Look 導覽
管理員可使用「移除 Look 導覽」功能,進一步自訂內嵌內容,特別是內嵌的探索和內嵌的資訊主頁。
從嵌入式探索中移除 Look 導覽
根據預設,具有 explore
和 save_content
權限的嵌入使用者,會在嵌入式探索的「探索動作」齒輪選單中看到下列選項:
- 「儲存為 Look」選項
- 「儲存並排程」選項 (適用於具有傳送或排程權限的嵌入使用者)
設為「已啟用」時,「移除 Look 導覽」功能會移除所有 Look 參照,包括內嵌式「探索」的「探索動作」齒輪選單中的「另存為 Look」和「儲存並排程」選項。
將選項設為「已停用」,即可在內嵌的探索中保留「外觀」的參照,以及「另存為外觀」和「儲存並排程」選項。
從嵌入式資訊主頁中移除 Look 導覽
如果移除 Look 導覽設為啟用,系統會移除內嵌探索和內嵌連結至 Look 的資訊主頁圖塊中,Look 的參照和導覽選項。
如果「移除 Look 導覽」設為「已停用」,嵌入使用者就能在連結 Look 的動態磚中,透過三點「動態磚動作」選單「查看 Look」。
資訊主頁嵌入內容導覽
啟用這個選項後,獲得必要權限的嵌入式資訊主頁檢視者,就能從嵌入式資訊主頁查看資料夾,以及當中的 Look 圖表和資訊主頁。如要讓嵌入式資訊主頁的檢視者複製、移動及刪除資訊主頁,必須啟用這項功能。
嵌入內容管理
啟用這項選項後,獲得必要權限的嵌入式資訊主頁檢視者,就能複製、移動及刪除資訊主頁。
無 Cookie 嵌入
從 Looker 23.8 開始,取得無 Cookie 工作階段時,可以加入嵌入網域。這是使用 Looker 「管理」>「嵌入」面板新增嵌入網域的替代方法。Looker 會將嵌入網域儲存在 Looker 內部資料庫,因此不會顯示在「管理」面板的「嵌入」頁面。嵌入網域會改為與無 Cookie 工作階段建立關聯,且只會在工作階段期間存在。如果您決定使用這項功能,請詳閱安全性最佳做法。
嵌入 JWT 密鑰
如要使用無 Cookie 嵌入功能,必須提供 JSON Web Token (JWT) 密鑰。無 Cookie 嵌入功能需要啟用嵌入單一登入驗證,但無 Cookie 嵌入功能會使用嵌入 JWT 密鑰,而非嵌入密鑰。
這個選項可讓你設定或重設嵌入 JWT 密鑰。設定 JWT 密鑰是不必要的,因為首次嘗試建立無 Cookie 內嵌工作階段時,系統就會建立 JWT 權杖。與嵌入密鑰不同,嵌入 JWT 密鑰不會公開,因為 Looker 伺服器只會在內部使用。
重設 JWT 權杖會使所有有效的不含 Cookie 嵌入工作階段失效。
嵌入密鑰
如要使用 Looker 的已簽署嵌入功能,必須提供嵌入密碼。
如要擷取嵌入密鑰,請選取「設定密鑰」按鈕。
如要變更密鑰,請選取「重設密鑰」按鈕,但請注意,這會導致所有現有的簽署嵌入內容失效。
嵌入 URI 驗證器
為 Looker 的簽署嵌入功能產生網址後,您可以將網址貼到「嵌入 URI 驗證器」欄位,然後按一下「測試 URI」,測試該網址。URI 驗證器會傳回訊息,指出簽署的嵌入網址是否有效。
輸入已簽署的嵌入網址後,「嵌入 URI 快速檢查」部分會顯示已簽署嵌入網址中包含的參數和值。