Administratoreinstellungen – Einbetten

Hinweis: Wenn Sie eine Looker (Google Cloud Core)-Instanz verwenden, wird diese Seite nur angezeigt, wenn Sie die Embed Edition von Looker (Google Cloud Core) verwenden.

Auf der Seite Einbetten im Bereich Plattform des Menüs Verwaltung können Sie Einstellungen für eingebettete Looker-Inhalte konfigurieren.

Zulassungsliste für eingebettete Domains

Sie müssen diese Einstellung verwenden, um JavaScript-Ereignisse zu nutzen, um Daten oder Aktionen zwischen einer übergeordneten Seite und einem Looker-iFrame zu übergeben.

Fügen Sie in diesem Fall die Domain, in der der iFrame verwendet wird, in dieses Feld ein und wählen Sie Aktualisieren aus.

Same-Origin-Schutzmaßnahmen für Looker-Anmeldeseiten

Auf der Looker-Anmeldeseite können Sie mit der Einstellung Same-Origin-Schutzmaßnahmen für Looker-Anmeldeseiten angeben, ob Sie die ursprungsübergreifende Einbettung zulassen möchten:

• Deaktiviert: Looker erlaubt die ursprungsübergreifende Einbettung.
• Aktiviert: Looker lässt keine ursprungsübergreifende Einbettung zu.

Für bestimmte Anwendungsfälle müssen Sie zulassen, dass Looker-Anmeldeseiten in einem Looker-iFrame angezeigt werden, auch wenn die übergeordnete Seite nicht mit dem Domainnamen der Looker-Instanz kompatibel ist. In diesen Fällen muss die Option Same-Origin Protection für Looker-Anmeldeseiten auf Deaktiviert gesetzt sein:

• Wenn Sie die private Einbettung von Looker-Inhalten in einem iFrame einer Webseite verwenden, die von einer Nicht-Looker-Domain gehostet wird, müssen Sie die Same-Origin-Schutzmaßnahmen für Looker-Anmeldeseiten deaktivieren, damit Looker die Anmeldeseite im iFrame anzeigen kann und Nutzer sich bei Looker anmelden können.

Legen Sie Same-Origin-Schutzmaßnahmen für Looker-Anmeldeseiten auf Aktiviert fest, wenn eine der folgenden Bedingungen zutrifft:

• Sie betten keine Looker-Inhalte ein.
• Sie verwenden nur signierte Einbettungen, da die Looker-Anmeldeseite nicht für signierte Einbettungen verwendet wird.

Wenn Sie die Einstellung für den Schutz vor demselben Ursprung ändern möchten, wählen Sie im Drop-down-Menü die gewünschte Option aus. Klicken Sie dann auf die Schaltfläche Aktualisieren, um Ihre Auswahl zu speichern.

SSO-Authentifizierung einbetten

Die Funktion SSO-Authentifizierung einbetten muss aktiviert sein, wenn Sie die Looker-Funktion Signierte Einbettung verwenden möchten. Wählen Sie dazu Aktiviert und dann Aktualisieren aus.

Benutzerdefinierte URL für Benachrichtigungen und Planung

Sofern nicht deaktiviert, enthalten E-Mails von eingebetteten Dashboards, entweder aus Benachrichtigungen oder geplanten Zustellungen, den Link Vollständiges Dashboard ansehen. Über diesen Link können die E‐Mail-Empfänger eine Verbindung zu ihrer Looker-Instanz herstellen und die in der E‐Mail bereitgestellten Daten genauer untersuchen.

Mit der Option Benutzerdefinierte URL für Benachrichtigungen und Planung können Sie eine benutzerdefinierte URL in Benachrichtigungen und geplanten E-Mail-Zustellungen konfigurieren, über die eingebettete Nutzer statt mit einer Looker-Instanz mit der eingebetteten Anwendung verknüpft werden.

Hinweis :Die Einbettungsanwendung ist für die Authentifizierung und Bestätigung aller Nutzer verantwortlich, die auf den Link klicken, um zu einer benutzerdefinierten URL zurückzukehren.

Domain für Zeitpläne und Zulassungsliste zu Benachrichtigungen einbetten

Geben Sie alle Domains an, auf die benutzerdefinierte URLs in E-Mail-Zustellungen verweisen dürfen. Die hier aufgeführten Domains werden im Dialogfeld für Planung und Benachrichtigungen im Feld Domain eingetragen.

Wenn dieses Feld leer ist, stehen keine benutzerdefinierten Links zur Verfügung, da der Nutzer im Dialogfeld für Planung oder Benachrichtigungen keine Domain auswählen kann.

Inhaltspfad auswählen

In diesem Drop-down-Menü können Sie auswählen, wie die URL im benutzerdefinierten Link formatiert werden soll. Folgende Optionen stehen zur Verfügung:

• Nur Domain einbetten: Die URL im benutzerdefinierten Link enthält nur die Domain, die im Planungs- oder Benachrichtigungsdialogfeld im Feld Domain ausgewählt wurde. Beispiel: app.customer.com

• Benutzerdefinierte URL: Die URL im benutzerdefinierten Link enthält die Domain, die im Feld Domain des Planungs- oder Benachrichtigungsdialogfelds ausgewählt wurde, sowie den Pfad, den der Nutzer im Planungs- oder Benachrichtigungsdialogfeld in das Feld Pfad eingegeben hat. Zum Beispiel: app.customer.com/my_embed_app.

• Domain-URL mit Looker-IDs einbetten: Die URL im benutzerdefinierten Link enthält die Domain, die im Planungs- oder Benachrichtigungsdialogfeld im Feld Domain ausgewählt wurde, sowie den Looker-Pfad zum eingebetteten Dashboard unter Verwendung der Content-ID. Beispiel: app.customer.com/dashboards/12

  Hinweis: Instanzen, für die ein bestimmtes Lizenzfeature aktiviert ist, fügen den Looker-Pfad mithilfe des Dashboard-Slug hinzu, auch wenn diese Option ausgewählt ist. Wenn Sie die Dashboard-ID in der URL des benutzerdefinierten Links verwenden möchten, öffnen Sie eine Supportanfrage.

• Domain-URL mit Looker-Slugs einbetten: Die URL im benutzerdefinierten Link enthält die Domain, die im Planungs- oder Benachrichtigungsdialogfeld im Feld Domain ausgewählt wurde, sowie den Looker-Pfad zum eingebetteten Dashboard unter Verwendung des Inhalts-Slug. Beispiel: app.customer.com/dashboards/CQ1fu99Z9Y1ggq2wcHDfMm

  Hinweis :Der Slug ist ein zufällig ausgewählter kurzer String, der als Alternative zum Content ID-Wert in URLs verwendet wird. Im vorherigen Beispiel ist CQ1fu99Z9Y1ggq2wcHDfMm der Dashboard-Slug. Sie können einen Dashboard-Slug aufrufen, indem Sie im Dreipunkt-Menü des Dashboards Link abrufen auswählen.

Inhaltspfad auswählen ist nicht verfügbar, wenn das Feld Domain für Zeitpläne und Zulassungslisten für Benachrichtigungen einbetten leer gelassen wird.

URL-Label

In dieses Feld können Sie einen neuen Standard-Linktext eingeben, der bei E-Mails den Text Gesamtes Dashboard ansehen ersetzt. Der Standardtext kann in den Dialogfeldern für Planung und Benachrichtigungen geändert werden.

Filter für eingebettete Looks anzeigen

Legen Sie diese Option auf Enabled (Aktiviert) fest, wenn Sie Filterwerte in eingebetteten Looks anzeigen möchten.

Setzen Sie diese Option auf Deaktiviert, um Filterwerte in eingebetteten Looks auszublenden.

Wählen Sie Aktualisieren aus, um die Einstellung zu speichern.

Look-Navigation entfernen

Mit der Funktion Looknavigation entfernen können Administratoren eingebettete Inhalte weiter anpassen, insbesondere eingebettete Explores und eingebettete Dashboards.

Look-Navigation aus eingebetteten Explores entfernen

Standardmäßig sehen eingebettete Nutzer mit den Berechtigungen explore und save_content im Zahnradmenü der Explore-Aktionen eines eingebetteten Explores die folgenden Optionen:

• Die Option Als Look speichern
• Die Option Speichern und planen (für eingebettete Nutzer mit den entsprechenden Berechtigungen zum Senden oder Planen)

Wenn die Option Look-Navigation entfernen auf Aktiviert gesetzt ist, werden alle Verweise auf Looks entfernt, einschließlich der Optionen Als Look speichern und Speichern und planen aus dem Zahnrad-Menü Explore-Aktionen des eingebetteten Explores.

Lassen Sie die Option Deaktiviert, um Verweise auf Looks und die Optionen Als Look speichern und Speichern und planen in eingebetteten Explores beizubehalten.

Look-Navigation aus eingebetteten Dashboards entfernen

Wenn Look-Navigation entfernen aktiviert ist, werden Verweise und Navigationsoptionen auf Looks aus eingebetteten Explores und eingebettete mit einem Look verknüpfte Dashboardkacheln entfernt.

Wenn die Option Look-Navigation entfernen deaktiviert ist, können Nutzer, die mit einem Look verknüpft sind, über das Dreipunkt-Menü Kachelaktionen in mit einem Look verknüpfte Kacheln die Option Look ansehen auswählen.

Dashboard-Einbettungsinhalt-Navigation

Wenn diese Option aktiviert ist, können eingebettete Dashboard-Betrachter, denen die erforderlichen Berechtigungen gewährt wurden, Ordner sowie die darin enthaltenen Looks und Dashboards aus eingebetteten Dashboards ansehen. Das Aktivieren dieser Funktion ist erforderlich, damit Betrachter eingebetteter Dashboards Dashboards kopieren, verschieben und löschen können.

Content-Management für eingebettete Inhalte

Wenn diese Option aktiviert ist, können eingebettete Dashboard-Betrachter, denen die erforderlichen Berechtigungen gewährt wurden, Dashboards kopieren, verschieben und löschen.

Einbettung ohne Cookies

Ab Looker 23.8 kann die Einbettungsdomain beim Erwerb der Sitzung ohne Cookies einbezogen werden. Dies ist eine Alternative zum Hinzufügen der eingebetteten Domain über den Looker-Bereich Admin > Einbetten. Looker speichert die eingebettete Domain in der internen Looker-Datenbank. Sie wird daher im Admin-Bereich auf der Seite Einbetten nicht angezeigt. Stattdessen wird die eingebettete Domain der Sitzung ohne Cookies zugeordnet und existiert nur für die Dauer der Sitzung. Lesen Sie die Best Practices für die Sicherheit, wenn Sie diese Funktion nutzen möchten.

Wichtig :Wenn Sie Einbettungen ohne Cookies verwenden möchten, muss unter Admin > Authentifizierung > Sitzungen auch die Einstellung Persistente Sitzungen aktiviert sein.

JWT-Secret einbetten

Hinweis: Diese Einstellung wird angezeigt, wenn die Option Embed SSO Authentication (SSO-Authentifizierung einbetten) Enabled und die Option Einbetten ohne Cookies aktiviert sind.

Ein JWT-Secret (JSON Web Token) ist erforderlich, um die Funktion zum Einbetten ohne Cookies nutzen zu können. Für die Einbettung ohne Cookies muss die Einbettungs-SSO-Authentifizierung aktiviert sein. Für die Einbettung ohne Cookies wird jedoch JWT-Secret einbetten statt Embed Secret verwendet.

Mit dieser Option kannst du das eingebettete JWT-Secret festlegen oder zurücksetzen. Das Festlegen des JWT-Secrets ist nicht erforderlich, da das JWT-Token beim ersten Versuch, eine Einbettungssitzung ohne Cookies zu erstellen, erstellt wird. Im Gegensatz zum Einbettungs-Secret wird das Einbettungs-JWT-Secret nie offengelegt, da es nur intern vom Looker-Server verwendet wird.

Durch das Zurücksetzen des JWT-Tokens werden alle aktiven Einbettungssitzungen ohne Cookies ungültig.

Secret einbetten

Hinweis: Diese Einstellung wird nur angezeigt, wenn Embed SSO Authentication (SSO-Authentifizierung einbetten) auf Enabled (Aktiviert) gesetzt ist.

Um die Looker-Funktion zur signierten Einbettung nutzen zu können, ist ein Einbettungs-Secret erforderlich.

Klicken Sie auf die Schaltfläche Set Secret (Secret festlegen), um das Einbettungs-Secret abzurufen.

Hinweis :Es ist wichtig, dass Sie das Secret sofort kopieren und an einem sicheren Ort speichern, da Sie das Secret nach dem Verlassen nicht von dieser Seite abrufen können.

Klicken Sie auf die Schaltfläche Secret zurücksetzen, um Ihr Secret zu ändern. Beachten Sie, dass dadurch jedoch alle vorhandenen signierten Einbettungen nicht mehr funktionieren.

Validierung des eingebetteten URI

Hinweis: Diese Einstellung wird nur angezeigt, wenn das Embed Secret (Secret eingebettet) festgelegt wurde.

Nachdem Sie eine URL für die Looker-Funktion für signierte Einbettungen generiert haben, können Sie sie testen, indem Sie sie in das Feld Validierung der eingebetteten URI einfügen und auf URI testen klicken. Die URI-Validierung gibt eine Nachricht zurück, die angibt, ob die signierte Einbettungs-URL gültig ist.

Nachdem Sie eine signierte Einbettungs-URL eingegeben haben, werden im Abschnitt Schnellprüfung der URI einbetten die Parameter und Werte der signierten Einbettungs-URL angezeigt.