Impostazioni amministratore - Incorpora

La pagina Incorpora nella sezione Piattaforma del menu Amministrazione ti consente di configurare le impostazioni per i contenuti di Looker incorporati.

Lista consentita dei domini incorporati

Devi utilizzare questa impostazione per usare gli eventi JavaScript per trasferire dati o azioni tra una pagina principale e un iframe di Looker.

In questo 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

Per la pagina di accesso a 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:

  • Disabilitato: 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 avere l'opzione Protezioni della stessa origine per le pagine di accesso di Looker impostata su Disabilitata:

  • Se utilizzi l'incorporamento privato dei contenuti di 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 Abilitate se una delle seguenti condizioni è vera:

  • Non incorpori alcun contenuto di Looker.
  • Utilizza solo l'incorporamento firmato, poiché la pagina di accesso di Looker non viene utilizzata per gli incorporamenti firmati.

Per modificare l'impostazione di 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 abilitata se vuoi utilizzare la funzionalità Incorporamento firmato di Looker. Per farlo, seleziona Attivato e poi Aggiorna.

Avvisi e pianificazione dell'URL personalizzato

A meno che non sia disattivato, i caricamenti di email da dashboard incorporate, da avvisi o distribuzioni pianificate, includono il link Visualizza dashboard completa. Questo link consente ai destinatari email di connettersi alla propria istanza Looker e di esplorare ulteriormente i dati consegnati nell'email.

L'opzione URL personalizzato per avvisi e pianificazione ti consente di configurare un URL personalizzato negli avvisi e nelle consegne email pianificate 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 possono rimandare gli URL personalizzati nei recapiti via email. I domini elencati qui verranno compilati nel campo Dominio nelle finestre di dialogo di pianificazione e avviso.

Se questo campo viene lasciato vuoto, i link personalizzati non sono disponibili poiché non ci sarà alcun dominio da selezionare per l'utente 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. Presenta le seguenti opzioni:

  • Incorpora solo 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 nella finestra di dialogo di pianificazione o degli avvisi, nonché il percorso inserito dall'utente nel campo Percorso della finestra di dialogo della pianificazione o degli 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 della finestra di dialogo di pianificazione o di avviso e il percorso Looker della dashboard incorporata utilizzando l'ID contenuto. 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 della finestra di dialogo di pianificazione o degli avvisi e il percorso Looker della 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 un nuovo testo predefinito del link, che sostituirà il testo Visualizza dashboard completa nei recapiti via email. Il testo predefinito può essere modificato nelle finestre di dialogo di pianificazione e avvisi.

Mostra filtri su Look incorporati

Imposta questa opzione su Attivata se vuoi visualizzare i valori del filtro nei Look incorporati.

Imposta questa opzione su Disabled (Disabilitata) 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 incorporate e le dashboard incorporate.

Rimozione della navigazione Look dalle esplorazioni incorporate

Per impostazione predefinita, gli utenti incorporati che hanno le autorizzazioni explore e save_content vedranno le seguenti opzioni nel menu a forma di ingranaggio delle azioni dell'esplorazione di un'esplorazione incorporata:

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 delle azioni dell'esplorazione dell'esplorazione incorporata.

Lascia l'opzione impostata su Disabilitata 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

Quando l'opzione Rimuovi navigazione Look è Abilitata, i riferimenti e le opzioni di navigazione ai Look dalle esplorazioni incorporate e ai riquadri della dashboard collegati all'aspetto incorporati verranno rimossi.

Quando l'opzione Rimuovi navigazione Look è Disattivata, gli utenti incorporati avranno la possibilità di Visualizza Look nel menu con tre puntini Azioni riquadro nei riquadri collegati all'aspetto.

Navigazione dei contenuti incorporati 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 in essi contenuti dalle dashboard incorporate. L'attivazione di questa funzionalità è necessaria per consentire ai visualizzatori delle dashboard incorporate di copiare, spostare ed eliminare le dashboard.

Incorpora 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. Si tratta di un'alternativa all'aggiunta del dominio incorporato tramite il riquadro Amministrazione > Incorpora di Looker. Looker salva il dominio incorporato nel database interno di Looker, quindi non verrà visualizzato nella pagina Incorpora del riquadro Amministrazione. Al contrario, il dominio di incorporamento è associato alla sessione senza cookie ed esiste solo per la durata della sessione. Se decidi di sfruttare questa funzionalità, consulta le best practice per la sicurezza.

Incorpora secret JWT

Per utilizzare la funzionalità di incorporamento senza cookie, è necessario un secret JWT (JSON Web Token). L'incorporamento senza cookie richiede l'attivazione dell'opzione Incorpora autenticazione SSO, mentre l'incorporamento senza cookie utilizza l'opzione Embed JWT Secret (Incorpora secret JWT) anziché Embed Secret (Incorpora secret).

Questa opzione 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 annullerà tutte le sessioni di incorporamento attive senza cookie.

Incorpora secret

È necessario un secret di incorporamento per utilizzare la funzionalità di incorporamento firmato di Looker.

Per recuperare il secret incorporato, seleziona il pulsante Imposta secret.

Per modificare il secret, seleziona il pulsante Reimposta secret. Tuttavia, tieni presente che questa operazione comporterà l'interruzione di tutti gli incorporamenti firmati esistenti.

Incorpora strumento di convalida URI

Dopo aver generato un URL per la funzionalità di incorporamento firmato di Looker, puoi testare l'URL incollandolo nel campo Strumento di convalida dell'URI di incorporamento e facendo clic su Verifica URI. Lo strumento di convalida 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 mostrerà i parametri e i valori inclusi nell'URL di incorporamento firmato.