Impostazioni amministratore - Incorpora

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

Lista consentita dominio incorporato

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

In questo caso, aggiungi il dominio in cui l'iframe viene utilizzato in questo campo, quindi seleziona Update (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 da quello della pagina iframe. Protegge da possibili attacchi di correzione 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 lo stesso criterio di origine:

  • Disattivato: Looker non applica lo stesso criterio dell'origine per la pagina di accesso.
  • Attivato: Looker applica lo stesso criterio dell'origine per la pagina di accesso.

Per alcuni casi d'uso, devi consentire alle pagine di accesso di Looker di essere visualizzate in un iframe di Looker anche quando la pagina principale non è compatibile con il nome di dominio dell'istanza di Looker. In questi casi, l'opzione Same-Origin Protections for Looker Login Pages deve essere impostata su Disabled:

  • Se utilizzi l'incorporamento privato dei contenuti Looker in un iframe di una pagina web ospitata da un dominio non di 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 Attivato se una delle seguenti condizioni è vera:

  • Non devi incorporare contenuti di Looker.
  • Puoi utilizzare solo l'incorporamento SSO, poiché la pagina di accesso di Looker non viene utilizzata per gli incorporamenti SSO.

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

Autenticazione SSO incorporata

La funzionalità Embed SSO Authentication (Incorpora autenticazione SSO) deve essere attivata se vuoi utilizzare la funzionalità Single Sign-On Embed (Incorporamento Single Sign-On) di Looker. Per farlo, seleziona Attivata, quindi Aggiorna.

Avvisi e pianificazione dell'URL personalizzato

Questa opzione è disponibile solo se hai attivato la funzionalità Lab URL personalizzati per email di avviso e pianificazione.

A meno che non sia disattivato, le email inviate da dashboard incorporate, provenienti da avvisi o revisioni programmate, includono un link con la scritta Visualizza dashboard completa. Questo link consente ai destinatari delle email di connettersi alla propria istanza di Looker e di esplorare ulteriormente i dati inviati nell'email.

L'opzione Avvisi e pianificazione dell'URL personalizzato consente di configurare un URL personalizzato negli avvisi di consegna e via email pianificata che collegheranno gli utenti di incorporamento all'applicazione di incorporamento, anziché un'istanza di Looker.

Incorpora il dominio per la lista consentita delle pianificazioni e degli avvisi

Specifica tutti i domini a cui possono essere collegati gli URL personalizzati nelle consegne via email. I domini elencati qui saranno completati con il campo Dominio nelle finestre di dialogo di pianificazione e avvisi.

Selezione parametri definiti

Questo menu a discesa consente di selezionare la quantità di informazioni da includere nell'URL personalizzato. Ha le seguenti opzioni:

  • Solo dominio incorporato: seleziona questa opzione quando l'URL personalizzato includerà solo un nome di dominio e non include informazioni sul routing. Ad esempio, se il dominio selezionato è app.customer.com, il link dell'URL personalizzato sarà app.customer.com.

  • URL definito dall'utente: seleziona questa opzione quando utilizzi ID univoci o percorsi di contenuti nell'URL personalizzato. Ad esempio, per configurare l'URL del link in modo che sia app.customer.com/report/salesoverview, seleziona il dominio app.customer.com nel campo Incorpora dominio per pianificazioni e avvisi della lista consentita e inserisci /report/salesoverview nel campo URL definito dall'utente.

  • Incorpora URL di dominio con la convenzione di denominazione di Looker: seleziona questa opzione quando utilizzi la sintassi del percorso dei contenuti di Looker oltre a un dominio personalizzato. Ad esempio, per configurare l'URL del link in modo che sia app.customer.com/dashboards/12, seleziona il dominio app.customer.com nel campo Incorpora dominio per pianificazioni e avvisi della lista consentita e inserisci /dashboards/12 nel campo Incorpora URL del dominio con la convenzione di denominazione di Looker.

La selezione dei parametri definiti non è disponibile se il campo Incorpora dominio per pianificazioni e avvisi nella lista consentita viene lasciato vuoto.

Etichetta URL

Utilizza questo campo per inserire un nuovo testo per il link, che sostituirà il testo Visualizza dashboard completa nelle distribuzioni via email.

Mostra i filtri sui look incorporati

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

Imposta questa opzione su Disattivato 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 Look dalle esplorazioni incorporate

Per impostazione predefinita, incorpora gli utenti che dispongono delle autorizzazioni explore e save_content nel menu a forma di ingranaggio Esplora azioni di un'esplorazione incorporata, inclusa l'opzione per Salvare come look. Se incorpora gli utenti che dispongono delle autorizzazioni di invio o pianificazione, vedrai anche l'opzione Salva e pianifica.

Quando è impostata su Attivata, la funzionalità Rimuovi la navigazione Look rimuove tutti i riferimenti ai Look, incluse le opzioni Salva come Look e Salva e pianifica dal menu a discesa Esplora azioni incorporato in Esplora.

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.

Rimuovere la navigazione look dalle dashboard incorporate

Oltre a rimuovere i riferimenti e la navigazione ai Look dalle esplorazioni incorporate, la funzionalità Rimuovi la navigazione Look rimuove anche i riferimenti dai riquadri collegati a Look incorporati nelle dashboard quando questa funzionalità è Attivata.

Se l'opzione Rimuovi navigazione Look è Disattivata, gli utenti di incorporamento avranno la possibilità di visualizzare i Look dai riquadri collegati al Look.

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 Looker Admin > Embed (Amministrazione > Incorpora). Looker salva il dominio di incorporamento nel database interno di Looker, quindi non verrà mostrato nel riquadro Admin > Embed (Amministrazione > Incorpora). Il dominio di incorporamento è associato alla sessione senza cookie ed esiste solo per la durata della sessione. Leggi le best practice per la sicurezza se decidi di avvalerti di questa funzionalità.

Incorpora JWT Secret

Quando l'opzione Incorpora autenticazione SSO è Attivata e l'opzione Incorporamento senza cookie è abilitata, questa impostazione viene mostrata.

Per utilizzare la funzionalità di incorporamento senza cookie, è necessario un secret JWT (JSON Web Token). Per l'incorporamento senza cookie è necessario attivare l'autenticazione SSO incorporata, ma l'incorporamento senza cookie utilizza Incorpora JWT Secret anziché Embed Secret.

Questa opzione ti consente di impostare o reimpostare il secret JWT per l'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 poiché viene utilizzato solo internamente dal server di Looker.

La reimpostazione del token JWT invaliderà tutte le sessioni di incorporamento senza cookie attive.

Incorpora secret

Per utilizzare la funzionalità di incorporamento con Single Sign-On 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 modo che non sia possibile recuperarlo da questa pagina dopo averlo lasciato.

Per modificare il secret, seleziona il pulsante Reimposta secret, ma tieni presente che questo comporterà eventuali incorporamenti SSO esistenti.

Incorpora URI URI

Questa impostazione viene visualizzata solo se è stato configurato il incorporamento del secret.

Dopo aver generato un URL per la funzionalità Single Sign-on Embed (Incorporamento Single Sign-On), puoi testare l'URL incollandolo nel campo Embed URI Validator (Incorpora URI URI) e facendo clic su Test URI (URI di test). Lo strumento di convalida URI restituirà un messaggio che indica se l'URL di incorporamento SSO è valido.

Dopo aver inserito un URL di incorporamento SSO, la sezione Controllo rapido dell'URI da incorporare mostra i parametri e i valori inclusi nell'URL di incorporamento SSO.