La pagina Incorpora nella sezione Piattaforma del menu Amministrazione consente di configurare le impostazioni per i contenuti di Looker incorporati.
Lista consentita dei domini incorporati
Devi usare questa impostazione per impiegare gli eventi JavaScript e trasferire dati o azioni tra una pagina principale e un iframe di Looker.
In tal caso, aggiungi a questo campo il dominio in cui viene utilizzato l'iframe e seleziona Aggiorna.
Protezioni della stessa origine per le pagine di accesso di Looker
Looker applica un criterio della stessa origine per i contenuti iframe, il che significa che una pagina non può essere visualizzata in un iframe se il nome di dominio della pagina principale è diverso dal nome di dominio della pagina iframe. Ciò protegge da possibili attacchi di compensazione dell'interfaccia utente, comunemente noti come clickjacking.
L'unica eccezione a questo criterio è la pagina di accesso di Looker. Per la pagina di accesso, puoi utilizzare l'impostazione Protezioni della stessa origine per le pagine di accesso di Looker per indicare se vuoi o meno applicare il criterio della stessa origine:
- Disattivato: Looker non applica il criterio della stessa origine per la pagina di accesso.
- Abilitato: Looker applica il criterio della stessa origine per la pagina di accesso.
Per determinati casi d'uso, devi consentire la visualizzazione delle pagine di accesso di Looker all'interno di un iframe di Looker anche quando la pagina padre non è compatibile con il nome di dominio dell'istanza di Looker. In questi casi, è necessario che l'opzione Protezioni della stessa origine per le pagine di accesso di Looker sia impostata su Disattivata:
- Se utilizzi l'incorporamento privato di contenuti Looker in un iframe di una pagina web ospitata da un dominio non Looker, devi disattivare le 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 Attivata se una delle seguenti condizioni è vera:
- Non incorpori alcun contenuto di Looker.
- Puoi utilizzare solo l'incorporamento firmato, poiché la pagina di accesso di Looker non viene utilizzata per gli incorporamenti firmati.
Per modificare l'impostazione della protezione della stessa origine, utilizza il menu a discesa per selezionare l'opzione che preferisci, quindi assicurati di selezionare il pulsante Aggiorna per salvare la selezione.
Incorpora autenticazione SSO
La funzionalità Incorpora autenticazione SSO deve essere attivata se vuoi utilizzare la funzionalità Incorporamento firmato di Looker. Per farlo, seleziona Attivata e quindi Aggiorna.
Avvisi e pianificazione dell'URL personalizzato
Se l'opzione non è disattivata, i recapiti delle email dalle dashboard incorporate, da avvisi o recapitazioni programmate, includono un link con la dicitura Visualizza dashboard completa. Questo link consente ai destinatari dell'email di connettersi alla loro istanza Looker ed esplorare ulteriormente i dati inviati nell'email.
L'opzione Avvisi e pianificazione dell'URL personalizzato ti consente di configurare un URL personalizzato negli avvisi e nelle consegne via email pianificate che collegheranno 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 nelle consegne via 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, in quanto l'utente non potrà selezionare alcun dominio nella finestra di dialogo della pianificazione o degli avvisi.
Seleziona percorso contenuti
Questo menu a discesa ti consente di selezionare la formattazione dell'URL nel link personalizzato. Offre le seguenti opzioni:
Incorpora solo il dominio: l'URL nel link personalizzato include solo il dominio selezionato nel campo Dominio della finestra di dialogo della pianificazione o degli avvisi. Ad esempio:
app.customer.com.URL definito dall'utente: l'URL nel link personalizzato include il dominio selezionato nel campo Dominio della finestra di dialogo di pianificazione o avvisi e il percorso inserito dall'utente nel campo Percorso della finestra di dialogo di pianificazione o di avviso. 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 Looker alla dashboard incorporata, utilizzando l'ID contenuti. Ad esempio:
app.customer.com/dashboards/12.Incorpora l'URL del 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 Looker alla dashboard incorporata utilizzando lo slug dei contenuti. Ad esempio:
app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.
L'opzione Seleziona percorso contenuti non è disponibile se il campo Incorpora dominio per pianificazioni e avvisi viene lasciato vuoto.
Etichetta URL
Utilizza questo campo per inserire il nuovo testo predefinito del link, che sostituirà il testo Visualizza dashboard completa nei recapiti email. Il testo predefinito può essere modificato nelle finestre di dialogo di pianificazione e di avviso.
Mostra filtri sui Look incorporati
Imposta questa opzione su Abilitata se vuoi visualizzare i valori del filtro nei Look incorporati.
Imposta questa opzione su Disattivata per nascondere i valori del filtro 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 e le dashboard incorporate.
Rimozione della navigazione del Look dalle esplorazioni incorporate
Per impostazione predefinita, gli utenti incorporati che dispongono delle autorizzazioni di explore e save_content vedranno le seguenti opzioni nel menu a forma di ingranaggio Esplora le azioni di un'esplorazione incorporata, inclusa l'opzione Salva come Look. Incorporando gli utenti che dispongono delle autorizzazioni di invio o pianificazione, vedranno anche l'opzione Salva e pianifica.
Se impostata su Attivata, 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 esplorazione dell'esplorazione incorporata.
Lascia l'opzione impostata su Disattivata per mantenere i riferimenti ai Look e le opzioni Salva come Look e Salva e pianifica nelle esplorazioni incorporate.
Rimozione della navigazione Look dalle dashboard incorporate
Oltre a rimuovere i riferimenti e la navigazione ai Look dalle esplorazioni incorporate, la funzionalità Rimuovi navigazione del Look rimuove anche i riferimenti dai riquadri collegati a Look nelle dashboard quando la funzionalità è abilitata.
Quando l'opzione Rimuovi navigazione Look è Disattivata, gli utenti incorporati avranno la possibilità di visualizzare Look nei riquadri collegati a Look.
Navigazione dei contenuti incorporamento nella dashboard
Quando questa opzione è abilitata, i visualizzatori delle dashboard incorporate a cui sono state concesse le autorizzazioni necessarie possono visualizzare le cartelle, 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.
Incorpora la gestione dei contenuti
Quando questa opzione è abilitata, 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 incorporato può essere incluso quando viene acquisita la sessione senza cookie. Questa è un'alternativa all'aggiunta del dominio incorporato utilizzando il riquadro Amministrazione > Incorpora di Looker. Looker salva il dominio incorporato nel database interno di Looker, in modo che non venga visualizzato nel riquadro Amministrazione > Incorpora. Il dominio incorporato viene invece associato alla sessione senza cookie ed esiste solo per la durata della sessione. Consulta le best practice per la sicurezza se decidi di usufruire di questa funzionalità.
Incorpora secret JWT
Quando l'opzione Incorpora autenticazione SSO è impostata su Attivata e l'opzione Incorporamento senza cookie è attivata, questa impostazione viene visualizzata.
Per utilizzare la funzionalità di incorporamento senza cookie è necessario un secret JWT (JSON Web Token). L'incorporamento senza cookie richiede l'attivazione dell'autenticazione SSO per l'incorporamento, mentre l'incorporamento senza cookie utilizza Incorpora secret JWT anziché Embed Secret.
Questa opzione ti consente di impostare o reimpostare il secret JWT incorporato. 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 rende non valide tutte le sessioni di incorporamento attive senza cookie.
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.
È importante copiare il secret e salvarlo subito in un posto sicuro, poiché non è possibile recuperarlo da questa pagina dopo averlo lasciato.
Per modificare il secret, seleziona il pulsante Reimposta secret. Tieni presente, tuttavia, che questa operazione comprometterà gli incorporamenti firmati esistenti.
Incorpora strumento di convalida dell'URI
Questa impostazione viene visualizzata solo se è stato impostato il Secret per l'incorporamento.
Dopo aver generato un URL per la funzionalità di incorporamento firmato di Looker, puoi testarlo incollandolo nel campo Strumento di convalida dell'URI di incorporamento e facendo clic su Prova URI. Lo strumento di convalida dell'URI restituirà un messaggio che indica se l'URL di incorporamento firmato è valido.
Dopo aver inserito un URL di incorporamento firmato, nella sezione Controllo rapido dell'URI di incorporamento verranno visualizzati i parametri e i valori inclusi nell'URL di incorporamento firmato.
