Incorporamento privato

Oltre all'incorporamento pubblico, puoi anche incorporare privatamente Look, esplorazioni e dashboard in modo privato, in modo da richiedere l'autenticazione utilizzando i dati di accesso di Looker, Google OAuth o OpenID Connect. Se un utente non è autenticato, puoi mostrare un messaggio di errore o visualizzare una schermata di accesso.

Gli utenti che hanno eseguito l'accesso e che hanno accesso a contenuti incorporati privati sono soggetti alle impostazioni impostate nel riquadro Sessioni Amministrazione, che determinano per quanto tempo possono rimanere collegati, se sono in grado di accedere da più browser e se vengono disconnessi dopo un periodo di inattività.

Se hai bisogno di una soluzione incorporata più avanzata o personalizzabile, consulta la pagina della documentazione relativa all'incorporamento con Single Sign-On (SSO).

Generare un URL di incorporamento

Per generare e copiare un URL per l'incorporamento privato per una dashboard, per una visualizzazione o una visualizzazione Esplora, seleziona Ottieni URL di incorporamento da un menu con tre puntini della dashboard o dal menu a forma di ingranaggio dell'azione Esplora su un esplorazione o un look. Looker mostrerà la finestra URL di incorporamento.

La finestra Ottieni URL di incorporamento include i seguenti elementi:

  1. Il campo URL per l'incorporamento mostra l'URL completo dell'incorporamento privato.
  2. Il campo Applica tema all'URL della dashboard consente di selezionare un tema da aggiungere all'URL di incorporamento se stai generando una dashboard o un URL di incorporamento Esplora e se la tua istanza ha i temi personalizzati abilitati. Il tema verrà applicato quando viene visualizzata la dashboard incorporata o la funzionalità Esplora.
  3. L'opzione Includi parametri attuali nell'URL ti consente di scegliere se applicare i parametri correnti, ad esempio i valori del filtro, all'URL per l'incorporamento. Se attivi questa opzione, questi parametri verranno applicati quando i contenuti incorporati vengono visualizzati.
  4. Fai clic sul pulsante Copia link per copiare l'URL di incorporamento completo negli appunti.

Dopo aver generato e copiato l'URL per l'incorporamento, puoi incollare l'URL in una nuova finestra o scheda del browser per visualizzare l'anteprima dei contenuti incorporati. Puoi utilizzare questo URL anche per incorporare i contenuti in un iframe.

Anteprima dei contenuti incorporati

Incolla l'URL per l'incorporamento nel browser per visualizzare l'anteprima del comportamento e dell'aspetto dei contenuti incorporati.

Visualizzare i contenuti incorporati in un iframe

Inserisci l'URL per l'incorporamento in un iframe. Ecco alcuni esempi:

  <iframe
      src="https://instance_name.cloud.looker.com/embed/dashboards/1"
      width="1000"
      height="2000"
      frameborder="0">
  </iframe>

Poi incorpora l'iframe come preferisci.

Modificare l'aspetto incorporato di una dashboard

Se visualizzi una dashboard con /embed nell'URL, visualizzerai l'aspetto della dashboard quando è incorporata.

Per impostazione predefinita, una dashboard incorporata viene visualizzata utilizzando il tema predefinito per l'istanza di Looker. Puoi modificare l'aspetto della tua dashboard incorporata in diversi modi, a seconda del tipo di dashboard che stai utilizzando:

  • Per qualsiasi tipo di dashboard, puoi specificare un nome diverso per il tema nell'URL di incorporamento per modificare il tema utilizzato per visualizzarla.
  • Per qualsiasi tipo di dashboard, puoi utilizzare l'argomento URL _theme per modificare singoli elementi del tema della dashboard.
  • Per una dashboard LookML, puoi anche modificare l'aspetto incorporato di una dashboard tramite il parametro embed_style.

Utilizzando l'argomento URL theme, l'opzione Modifica impostazioni di incorporamento o il parametro embed_style apporta modifiche solo alla dashboard a cui viene applicato l'argomento, l'opzione o il parametro. Se vuoi personalizzare l'aspetto di più dashboard incorporate, utilizza un tema.

Alcune impostazioni di visualizzazione hanno la precedenza su altre. Per saperne di più, consulta la pagina della documentazione Creare e applicare temi per dashboard incorporate ed esplorazioni.

Attiva la schermata di accesso per gli incorporamenti privati

Puoi aggiungere il parametro allow_login_screen=true al tuo URL di incorporamento se vuoi mostrare una schermata di accesso agli utenti che non hanno ancora eseguito l'accesso. Ecco alcuni esempi:

<iframe src="https://instance_name.cloud.looker.com/embed/looks/4?allow_login_screen=true"></iframe>
                                                            ^^^^^^^^^^^^^^^^^^^^^^^

Se non aggiungi questo parametro, verrà visualizzato un errore 401 agli utenti che non hanno ancora eseguito l'accesso.