La pagina Embed (Incorpora) nella sezione Platform (Piattaforma) del menu Admin (Amministrazione) ti consente di configurare le impostazioni per i contenuti di Looker incorporati.
Lista consentita di domini incorporati
Devi utilizzare questa impostazione per utilizzare gli eventi JavaScript per passare dati o azioni tra una pagina principale e un iframe di Looker.
In questo caso, aggiungi il dominio in cui viene utilizzato l'iframe a questo campo, quindi seleziona Aggiorna.
Protezioni della stessa origine per le pagine di accesso di Looker
Per la pagina di accesso di Looker, puoi utilizzare l'impostazione Protezioni della stessa origine per le pagine di accesso di Looker per indicare se vuoi consentire o meno l'incorporamento multiorigine:
- Disattivato: Looker consente l'incorporamento multiorigine.
- Attivato: Looker non consente l'incorporamento multiorigine.
Per alcuni casi d'uso, devi consentire la visualizzazione delle pagine di accesso di Looker all'interno di un iframe di Looker anche quando la pagina principale non è compatibile con il nome di dominio dell'istanza di Looker. In questi casi, devi impostare l'opzione Protezioni della stessa origine per le pagine di accesso di Looker su Disattivato:
- Se utilizzi l'incorporamento privato di contenuti di Looker in un iframe di una pagina web ospitata da un dominio non Looker, devi disattivare Protezioni della stessa origine per le pagine di accesso di Looker in modo che Looker possa visualizzare la pagina di accesso nell'iframe e consentire agli utenti di accedere a Looker.
Imposta Protezioni della stessa origine per le pagine di accesso di Looker su Attivato se si verifica una delle seguenti condizioni:
- Non incorpori alcun contenuto di Looker.
- Utilizzi solo l'incorporamento firmato, poiché la pagina di accesso di Looker non viene utilizzata per gli incorporamenti firmati.
Per modificare l'impostazione per la protezione della stessa origine, utilizza il menu a discesa per selezionare l'opzione scelta, quindi seleziona il pulsante Aggiorna per salvare la selezione.
Incorpora autenticazione SSO
La funzionalità Incorpora autenticazione SSO deve essere attivata se vuoi utilizzare la funzionalità di incorporamento firmato di Looker. Per farlo, seleziona Attivato e poi Aggiorna.
Avvisi e pianificazione dell'URL personalizzato
Se non disabilitati, gli invii di email dalle dashboard incorporate, sia da avvisi sia da invii pianificati, includono un link con il testo Visualizza la dashboard completa. Questo link consente ai destinatari delle email di connettersi alla propria istanza di Looker ed esplorare ulteriormente i dati forniti nell'email.
L'opzione Avvisi e pianificazione dell'URL personalizzato ti consente di configurare un URL personalizzato negli avvisi e nelle email programmate che collegherà gli utenti incorporati all'applicazione di incorporamento anziché a un'istanza di Looker.
Incorpora il dominio per la lista consentita delle pianificazioni e degli avvisi
Specifica tutti i domini a cui potrebbero rimandare gli URL personalizzati negli invii di email. I domini elencati qui verranno inseriti nel campo Dominio nelle finestre di dialogo di pianificazione e avvisi.
Se questo campo viene lasciato vuoto, i link personalizzati non sono disponibili, poiché non ci sarà alcun dominio che un utente potrà selezionare nella finestra di dialogo di pianificazione o avvisi.
Seleziona percorso contenuti
Questo menu a discesa ti consente di selezionare il formato dell'URL nel link personalizzato. Sono disponibili le seguenti opzioni:
Solo dominio di incorporamento : l'URL nel link personalizzato include solo il dominio selezionato nel campo Dominio nella finestra di dialogo di pianificazione o avvisi. Ad esempio,
app.customer.com.URL definito dall'utente : l'URL nel link personalizzato include il dominio selezionato nel campo Dominio nella finestra di dialogo di pianificazione o avvisi e il percorso inserito dall'utente nel campo Percorso nella finestra di dialogo di pianificazione o avvisi. Ad esempio,
app.customer.com/my_embed_app.Incorpora l'URL di dominio con ID Looker : l'URL nel link personalizzato includerà il dominio selezionato nel campo Dominio nella finestra di dialogo di pianificazione o avvisi e il percorso di Looker alla dashboard incorporata, utilizzando l'ID del contenuto. Ad esempio,
app.customer.com/dashboards/12.Incorpora l'URL di dominio con slug di Looker : l'URL nel link personalizzato include il dominio selezionato nel campo Dominio nella finestra di dialogo di pianificazione o avvisi e il percorso di Looker alla dashboard incorporata, utilizzando lo slug del contenuto. Ad esempio,
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
L'opzione Seleziona percorso contenuti non è disponibile se il campo Incorpora il dominio per la lista consentita delle pianificazioni e degli avvisi viene lasciato vuoto.
Etichetta URL
Utilizza questo campo per inserire un nuovo testo del link predefinito, che sostituirà il testo Visualizza la dashboard completa negli invii di email. Il testo predefinito può essere modificato nelle finestre di dialogo di pianificazione e avvisi.
Mostra filtri su Look incorporati
Imposta questa opzione su Attivato se vuoi visualizzare i valori dei filtri nei Look incorporati.
Imposta questa opzione su Disattivato per nascondere i valori dei filtri nei Look incorporati.
Seleziona Aggiorna per salvare l'impostazione.
Rimuovi navigazione Look
La funzionalità Rimuovi navigazione Look consente agli amministratori di personalizzare ulteriormente i contenuti incorporati, in particolare le esplorazioni incorporate e le dashboard incorporate.
Rimuovere la navigazione Look dalle esplorazioni incorporate
Per impostazione predefinita, gli utenti incorporati che dispongono delle autorizzazioni explore e save_content vedranno le seguenti opzioni nel menu a forma di ingranaggio Azioni di esplorazione di un'esplorazione incorporata:
- L'opzione Salva come Look
- L'opzione Salva e pianifica (per gli utenti incorporati che dispongono delle autorizzazioni di invio o pianificazione)
Se impostata su Attivato, la funzionalità Rimuovi navigazione Look rimuove tutti i riferimenti ai Look, incluse le opzioni Salva come Look e Salva e pianifica, dal menu a forma di ingranaggio Azioni di esplorazione dell'esplorazione incorporata.
Lascia l'opzione impostata su Disattivato per mantenere i riferimenti ai Look e le opzioni Salva come Look e Salva e pianifica nelle esplorazioni incorporate.
Rimuovere la navigazione Look dalle dashboard incorporate
Quando l'opzione Rimuovi navigazione Look è Attivato, i riferimenti e le opzioni di navigazione ai Look dalle esplorazioni incorporate e dai riquadri della dashboard collegati ai Look incorporati verranno rimossi.
Quando l'opzione Rimuovi navigazione Look è Disattivato, gli utenti incorporati avranno la possibilità di Visualizzare il Look nel menu con tre puntini Azioni riquadro nei riquadri collegati ai Look.
Navigazione tra i contenuti incorporati della dashboard
Quando questa opzione è attivata, i visualizzatori delle dashboard incorporate a cui sono state concesse le autorizzazioni necessarie possono visualizzare le cartelle e i Look e le dashboard che contengono dalle dashboard incorporate. L'attivazione di questa funzionalità è necessaria per consentire ai visualizzatori delle dashboard incorporate di copiare, spostare ed eliminare le dashboard.
Gestione dei contenuti incorporati
Quando questa opzione è attivata, i visualizzatori delle dashboard incorporate a cui sono state concesse le autorizzazioni necessarie possono copiare, spostare ed eliminare le dashboard.
Incorporamento senza cookie
A partire da Looker 23.8, il dominio di incorporamento può essere incluso quando viene acquisita la sessione senza cookie. Questa è un'alternativa all'aggiunta del dominio di incorporamento utilizzando il riquadro Amministrazione > Incorpora di Looker. Looker salva il dominio di incorporamento nel database interno di Looker, quindi non verrà visualizzato nella pagina Incorpora del riquadro Amministrazione. Il dominio di incorporamento è invece associato alla sessione senza cookie ed esiste solo per la durata della sessione. Esamina le best practice di sicurezza se decidi di usufruire di questa funzionalità.
Incorpora secret JWT
Per utilizzare la funzionalità di incorporamento senza cookie è necessario un secret JWT (JSON Web Token). L'incorporamento senza cookie richiede che l'opzione Incorpora autenticazione SSO sia attivata, ma utilizza Incorpora secret JWT anziché Incorpora secret.
Questa opzione ti consente di impostare o reimpostare il secret JWT di incorporamento. L'impostazione del secret JWT non è necessaria, poiché il primo tentativo di creare una sessione di incorporamento senza cookie creerà il token JWT. A differenza del secret di incorporamento, il secret JWT di incorporamento non viene mai esposto perché viene utilizzato solo internamente dal server Looker.
La reimpostazione del token JWT invaliderà tutte le sessioni di incorporamento senza cookie attive.
Incorpora secret
Per utilizzare la funzionalità di incorporamento firmato di Looker è necessario un secret di incorporamento.
Per recuperare il secret di incorporamento, seleziona il pulsante Imposta secret.
Per modificare il secret, seleziona il pulsante Reimposta secret, ma tieni presente che questa operazione interromperà tutti gli incorporamenti firmati esistenti.
Strumento di convalida URI di incorporamento
Dopo aver generato un URL per la funzionalità di incorporamento firmato di Looker, puoi testare l'URL incollandolo nel campo Convalida URI di incorporamento e facendo clic su Testa URI. Il validatore URI restituirà un messaggio che indica se l'URL di incorporamento firmato è valido.
Dopo aver inserito un URL di incorporamento firmato, la sezione Controllo rapido dell'URI di incorporamento visualizzerà i parametri e i valori inclusi nell'URL di incorporamento firmato.