Impostazioni amministratore - Incorporamento

La pagina Incorpora nella sezione Piattaforma del menu 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 trasmettere 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 e 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'embedding cross-origin:

  • Disattivato: Looker consente l'incorporamento cross-origin.
  • Attivato: Looker non consente l'incorporamento cross-origin.

Per alcuni casi d'uso, devi consentire la visualizzazione delle pagine di accesso di Looker in 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 Disattivata:

  • 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 mostrare 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 si verifica una delle seguenti condizioni:

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

Per modificare l'impostazione per la protezione di origine, utilizza il menu a discesa per selezionare l'opzione che preferisci, quindi assicurati di selezionare il pulsante Aggiorna per salvare la selezione.

Incorporare l'autenticazione SSO

La funzionalità Esegui l'autenticazione SSO per l'embedding deve essere attivata se vuoi utilizzare la funzionalità di embedding firmato di Looker. Per farlo, seleziona Attivato e poi Aggiorna.

Avvisi e pianificazione dell'URL personalizzato

A meno che non siano disattivati, gli invii via email delle dashboard incorporate, provenienti da avvisi o 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 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 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 possono fare riferimento gli URL personalizzati nelle importazioni 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 l'utente potrà selezionare 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 nella finestra di dialogo di 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 di avviso e il percorso inserito dall'utente nel campo Percorso nella 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 degli avvisi e il percorso di Looker alla dashboard incorporata, utilizzando l'ID dei contenuti. Ad esempio: app.customer.com/dashboards/12.

  • Incorpora l'URL di dominio con gli slug di Looker: l'URL nel link personalizzato include il dominio selezionato nel campo Dominio nella finestra di dialogo di pianificazione o degli avvisi e il percorso di Looker alla dashboard incorporata, utilizzando lo slug dei contenuti. Ad esempio: app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm.

L'opzione Seleziona il percorso dei contenuti non è disponibile se il campo Incorpora il dominio per la lista consentita delle pianificazioni e degli avvisi non è compilato.

Etichetta URL

Utilizza questo campo per inserire il nuovo testo del link predefinito, che sostituirà il testo Visualizza la dashboard completa nelle email inviate. 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 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.

Rimuovere la 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 di Look dalle esplorazioni incorporate

Per impostazione predefinita, gli utenti che hanno le autorizzazioni explore e save_content vedranno le seguenti opzioni nel menu a forma di ingranaggio Azioni esplora 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 Azioni 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 di Look dalle dashboard incorporate

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

Quando l'opzione Rimuovi navigazione look è impostata su Disattivato, gli utenti incorporati avranno la possibilità di Visualizza look nel menu Azioni riquadro con tre puntini nei riquadri collegati ai look.

Navigazione dei contenuti incorporati nella dashboard

Quando questa opzione è attiva, gli utenti che visualizzano le 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 è attiva, 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. Si tratta di 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, pertanto non verrà visualizzato nella pagina Incorpora del riquadro Amministrazione. Il dominio dell'embed, invece, è associato alla sessione senza cookie ed esiste solo per la durata della sessione. Se decidi di utilizzare questa funzionalità, consulta le best practice di sicurezza.

Incorpora il secret JWT

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

Questa opzione ti consente di impostare o reimpostare il secret JWT incorporato. L'impostazione del segreto JWT non è necessaria, poiché il token JWT verrà creato al primo tentativo di creare una sessione di incorporamento senza cookie. A differenza del secret di incorporamento, il secret JWT di incorporamento non viene mai esposto perché viene utilizzato solo internamente dal server Looker.

Il ripristino 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 segreto di incorporamento.

Per recuperare il secret di incorporamento, seleziona il pulsante Imposta secret.

Per modificare il secret, seleziona il pulsante Reimposta secret. Tieni presente che questa operazione comporterà l'interruzione di eventuali incorporamenti firmati esistenti.

Verificatore di URI incorporati

Dopo aver generato un URL per la funzionalità di incorporamento firmato di Looker, puoi testarlo incollandolo nel campo Validatore URI di incorporamento e facendo clic su Testa 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, la sezione Controllo rapido dell'URI di incorporamento mostra i parametri e i valori inclusi nell'URL di incorporamento firmato.