Private Einbettung

Zusätzlich zur öffentlichen Einbettung können Sie Looker, Explores und Dashboards privat einbetten, sodass eine Authentifizierung über Looker-Anmeldung, Google OAuth oder OpenID Connect erforderlich ist. Wenn ein Nutzer nicht authentifiziert ist, können Sie entweder eine Fehlermeldung anzeigen oder einen Anmeldebildschirm anzeigen.

Nutzer, die angemeldet sind und auf privat eingebettete Inhalte zugreifen, unterliegen den Einstellungen im Steuerfeld Sitzungen Admin. Mit diesen Einstellungen wird festgelegt, wie lange sie angemeldet bleiben, ob sie sich in mehreren Browsern anmelden können und ob sie nach einer bestimmten Zeit der Inaktivität abgemeldet werden.

Wenn Sie eine erweiterte oder anpassbare eingebettete Lösung benötigen, sehen Sie sich unsere Dokumentation zur Einmalanmeldung (SSO) an.

Eingebettete URL generieren

Wenn Sie eine private Einbettungs-URL für ein Dashboard, einen Look oder eine Explore-Visualisierung generieren und kopieren möchten, wählen Sie in einem Dashboard-Dreipunkt-Menü die Option Eingebettete URL abrufen aus oder klicken Sie auf Entdecken oder Entdecken auf das Aktionsmenü zum Entdecken. In Looker wird das Fenster URL einbetten angezeigt.

Das Fenster URL einbetten enthält die folgenden Elemente:

  1. Im Feld URL einbetten wird die vollständige private Einbettungs-URL angezeigt.
  2. Im Feld Design auf Dashboard-URL anwenden können Sie ein Design auswählen, das der eingebetteten URL hinzugefügt werden soll, wenn Sie ein Dashboard oder eine eingebettete URL zum Entdecken erstellen und für Ihre Instanz benutzerdefinierte Designs aktiviert sind. Das Design wird angewendet, wenn das eingebettete Dashboard oder die Funktion „Erkunden“ aufgerufen wird.
  3. Mit dem Schieberegler Aktuelle Parameter in URL einschließen können Sie auswählen, ob die aktuellen Parameter, etwa Filterwerte, auf die eingebettete URL angewendet werden sollen. Wenn diese Option aktiviert ist, werden diese Parameter angewendet, wenn der eingebettete Inhalt angesehen wird.
  4. Klicken Sie auf die Schaltfläche Link kopieren, um die vollständige Einbettungs-URL in die Zwischenablage zu kopieren.

Nachdem du die eingebettete URL generiert und kopiert hast, kannst du die URL in das Fenster eines neuen Browserfensters oder Tabs einfügen. Sie können mit dieser URL auch den Inhalt in einen iFrame einbetten.

Vorschau des eingebetteten Inhalts

Fügen Sie die Einbettungs-URL in den Browser ein, um das Verhalten und die Darstellung der eingebetteten Inhalte in der Vorschau zu sehen.

Eingebetteten Inhalt in einem iFrame ansehen

Fügen Sie die eingebettete URL in einen iFrame ein. Beispiel:

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

Und betten Sie dann den iFrame nach Bedarf ein.

Darstellung der Einbettung eines Dashboards ändern

Wenn Sie in der URL ein Dashboard mit /embed aufrufen, sehen Sie, wie das Dashboard nach dem Einbetten angezeigt wird.

Standardmäßig wird ein eingebettetes Dashboard mit dem Standarddesign für Ihre Looker-Instanz angezeigt. Sie können die Darstellung des eingebetteten Dashboards je nach Typ des verwendeten Dashboards auf mehrere Arten ändern:

  • Für alle Arten von Dashboards können Sie in der eingebetteten URL einen anderen Designnamen angeben, um das zur Anzeige des Dashboards verwendete Design zu ändern.
  • Sie können mit dem URL-Argument _theme für jeden Dashboard-Typ einzelne Designelemente im Dashboard ändern.
  • Bei einem LookML-Dashboard können Sie die eingebettete Darstellung eines Dashboards auch über den Parameter embed_style ändern.

Mit dem URL-Argument theme, der Option Einstellungen für die Einbettung bearbeiten oder dem Parameter embed_style können nur Änderungen am Dashboard vorgenommen werden, auf die das Argument, die Option oder der Parameter angewendet wird. Wenn Sie die Darstellung mehrerer eingebetteter Dashboards anpassen möchten, verwenden Sie stattdessen ein Design.

Einige Anzeigeeinstellungen setzen andere außer Kraft. Weitere Informationen finden Sie auf der Dokumentationsseite zum Erstellen und Anwenden von Designs für eingebettete Dashboards und Auswertungen.

Anmeldebildschirm für private Einbettungen aktivieren

Sie können den Parameter allow_login_screen=true zu Ihrer eingebetteten URL hinzufügen, wenn Sie einen Anmeldebildschirm für Nutzer anzeigen möchten, die sich noch nicht angemeldet haben. Beispiel:

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

Wenn Sie diesen Parameter nicht hinzufügen, wird Benutzern, die noch nicht angemeldet sind, die Fehlermeldung 401 angezeigt.