Impostazioni amministratore - Incorpora

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

Lista consentita dei domini incorporati

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

In tal caso, aggiungi al campo il dominio in cui viene utilizzato l'iframe e poi 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 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 Disabilitata:

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

  • Non incorpori alcun contenuto di Looker.
  • Puoi utilizzare solo l'incorporamento firmato, in quanto la pagina di accesso di Looker non viene utilizzata per gli incorporamenti firmati.

Per modificare l'impostazione della protezione dalla stessa origine, utilizza il menu a discesa per selezionare l'opzione desiderata, 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à di incorporamento firmato di Looker. Per farlo, seleziona Attivato e poi Aggiorna.

Avvisi e pianificazione dell'URL personalizzato

A meno che non sia disattivato, le recapitazioni delle email da 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 propria 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 colleghino 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 nelle consegne via email. I domini elencati qui verranno inseriti nel campo Dominio nelle finestre di dialogo di pianificazione e degli 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 di pianificazione o di avviso.

Seleziona percorso contenuti

Questo menu a discesa ti consente di selezionare la formattazione dell'URL nel link personalizzato. Le opzioni disponibili sono le seguenti:

  • Incorpora solo il dominio: l'URL nel link personalizzato include solo il dominio selezionato nel campo Dominio della finestra di dialogo di pianificazione o di avviso. 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 degli avvisi e 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 degli avvisi e il percorso Looker alla dashboard incorporata, utilizzando l'ID 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 della finestra di dialogo di pianificazione o degli avvisi e il percorso Looker alla dashboard incorporata che utilizza lo slug dei contenuti. Ad esempio: app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

Seleziona percorso contenuti non è disponibile se il campo Incorpora dominio per liste consentite di pianificazioni e avvisi è lasciato vuoto.

Etichetta URL

Utilizza questo campo per inserire un nuovo testo predefinito per il link, che sostituirà il testo Visualizza dashboard completa nei caricamenti tramite 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 Attivata se vuoi visualizzare i valori del filtro nei Look incorporati.

Imposta questa opzione su 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 esplorazioni e dashboard incorporate.

Rimozione della navigazione dei 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 Azioni di 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 Esplora azioni dell'esplorazione incorporata.

Lascia l'opzione impostata su Disattivati per mantenere i riferimenti ai Look e le opzioni Salva come Look e Salva e pianifica nelle esplorazioni incorporate.

Rimozione della navigazione dei Look dalle dashboard incorporate

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

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

Dashboard incorporamento navigazione contenuti

Quando questa opzione è abilitata, i visualizzatori di dashboard incorporate a cui sono state concesse le autorizzazioni necessarie possono visualizzare le cartelle, i Look e le dashboard al loro interno 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 è attivata, i visualizzatori di 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 al momento dell'acquisizione della sessione senza cookie. Questa è un'alternativa all'aggiunta del dominio incorporato utilizzando il riquadro Amministratore > Incorpora di Looker. Looker salva il dominio incorporato nel database interno di Looker, quindi non verrà visualizzato nella pagina Embed (Incorpora) del riquadro Admin (Amministrazione). Il dominio incorporato viene invece associato alla sessione senza cookie ed esiste solo per la durata della sessione. Leggi le best practice per la sicurezza se decidi di usufruire di questa funzionalità.

Incorpora secret JWT

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

Questa opzione consente di impostare o reimpostare il secret di incorporamento JWT. 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 di incorporamento JWT 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

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

Per recuperare il secret di incorporamento, seleziona il pulsante Set Secret (Imposta secret).

Per modificare il secret, seleziona il pulsante Reset Secret (Reimposta secret): tuttavia, questo eliminerà eventuali 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 URI incorporamento e facendo clic su Verifica 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 incorporamento verranno visualizzati i parametri e i valori inclusi nell'URL di incorporamento firmato.