Dashboard- und Genie-Agent-Einbettung verwalten

Diese Seite zeigt, wie Arbeitsbereichsadministratoren Einbettungsoptionen für AI/BI-Dashboards und Genie Agents verwalten können.

Welche Arten von Einbettungen können Sie verwenden?

Sie können Dashboards und Genie Agents sicher in externe Websites und Anwendungen einbetten.

Dashboardeinbettung

Sie können Dashboards auf folgende Weise einbetten:

• Databricks-basic embedding: Dashboardautoren können iframe-Einbettungscode mithilfe des Dialogfelds "Freigeben " generieren. Arbeitsbereichsadministratoren können verwalten, welche Domänen, falls vorhanden, für das Hosten eines eingebetteten Dashboards genehmigt werden. Das Einbetten von Dashboards erfordert, dass Benutzer Cookies von Drittanbietern aktiviert haben. Arbeitsbereichsadministratoren müssen das Einbetten in den Arbeitsbereich aktivieren und die Liste der berechtigten Domänen definieren. Siehe Grundlegendes Dashboard-Einbettung.

• Embedding für externe Benutzer: (Öffentliche Vorschau) Sie können eine externe Anwendung so konfigurieren, dass sie sich bei Azure Databricks mit einem Dienstprinzipal authentifiziert und auf ein Dashboard zugreift. Benutzer, die auf Ihre externe Anwendung zugreifen können, können auf das Dashboard zugreifen. Optional können Sie die im Dashboard dargestellten Daten basierend auf dem Benutzer filtern, der darauf zugreift. Arbeitsbereichsadministratoren müssen die externe Anwendung so konfigurieren, dass der Dienstprinzipal und die erforderlichen OAuth-Tokens für die Authentifizierung verwendet werden. Siehe Was bedeutet Embedden für externe Benutzer?.

Weitere Informationen zu den verfügbaren Dashboardeinbettungsoptionen finden Sie unter "Einbetten eines Dashboards".

Genie Agent Einbettung

• Genie Agent iframe embedding: Genie Agent-Autoren können iframe-Einbettungscode aus dem Dialogfeld "Freigeben " generieren. Benutzer, die Zugriff auf die Einbettungsanwendung haben, können Eingabeaufforderungen senden und Ergebnisse anzeigen, ohne die Raumkonfiguration zu bearbeiten. Arbeitsbereichsadministratoren müssen die zulässigen Oberflächen für das Einbetten definieren, bevor Autoren einen Genie-Agent auf diese Weise freigeben können. Siehe Einen Genie-Agent in eine externe App einbetten und Zulässige Einbettungsziele steuern.

Zulässige Einbettungsziele kontrollieren

Das Einbetten eines Dashboards oder Eines Genie-Agents erfordert, dass die externe Website explizit zulässig ist. So fügen Sie zulässige Einbettungsziele zu Ihrem Arbeitsbereich hinzu:

1. Klicken Sie in der oberen Leiste des Azure Databricks Arbeitsbereichs auf Ihren Benutzernamen, und wählen Sie Settings aus.

2. Klicken Sie auf Security (Sicherheit).

3. Scrollen Sie nach unten zum Abschnitt "Externer Zugriff ".

4. Verwenden Sie im Abschnitt "Dashboards einbetten " das Dropdownmenü, um die Einbettungsrichtlinie für Ihren Arbeitsbereich festzulegen. Diese Einstellung gilt sowohl für Dashboards als auch für Genie Agents.

   Es gibt drei Richtlinienoptionen:

   • Zulassen: Dashboards und Genie Agents können in jede beliebige Domäne eingebettet werden.
   • Genehmigte Domänen zulassen: Dashboards und Genie Agents können nur in Websites eingebettet werden, die der genehmigten Liste entsprechen.
   • Verweigern: Dashboards und Genie Agents können nicht in eine beliebige Domäne eingebettet werden.

Wenn Sie "Genehmigte Domänen zulassen" auswählen, verwenden Sie die folgenden Anweisungen, um Ihre Liste der genehmigten Domänen zu verwalten:

1. Klicken Sie neben "Dashboards einbetten" auf "Verwalten".
2. Geben Sie eine Domäne im Textfeld des Dialogs Genehmigte Domäne ein. Klicken Sie nach jedem Eintrag auf "Domäne hinzufügen ".
3. Klicken Sie auf "Speichern".

Hinweis

Um Ihr Dashboard oder Genie Agent auf einer Google-Website einzubetten, müssen Sie zusätzlich zur Adresse, die Ihrer jeweiligen Website zugeordnet ist, mehrere Domänen zulassen, die im Besitz von Google sind und von Google verwendet werden. Die erforderlichen Websites sind:

• sites.google.com
• www.gstatic.com
• *.googleusercontent.com

Tipps zum Definieren genehmigter Domänen und Routen

Um zulässige Hosts anzugeben, verwenden Sie die in der Dokumentation zur Inhaltssicherheitsrichtlinie von W3C definierte Grammatik. Die Beispiele in diesem Abschnitt veranschaulichen einige gängige Muster.

Unterdomänen zulassen

Um alle Unterdomänen für eine bestimmte Domäne zuzulassen, verwenden Sie vor dem Domänennamen ein Wildcardsymbol (*). Die folgenden Beispiele verwenden *.databricks.com als Beispieldomäne.

• Übereinstimmungen: Jede Unterdomäne
  • some.databricks.com
  • app.databricks.com
  • anything.databricks.com
• Stimmt nicht überein: Alles, was über eine andere Domäne verfügt.
  • another-databricks.com
  • app-databricks.com

Nächste Schritte

• Einrichten grundlegender Einbettung: Konfigurieren Sie die Einbettung für Benutzer mit Databricks-Konten, die sich direkt anmelden können, um Dashboards anzuzeigen. Siehe Grundlegendes Dashboard-Einbettung.
• Konfigurieren der Einbettung für externe Benutzer: Einrichten der Einbettung für externe Benutzer, damit Benutzer ohne Databricks-Konten über die Dienstprinzipalauthentifizierung auf Dashboards zugreifen können. Siehe Was bedeutet Embedden für externe Benutzer?.
• Einen Genie-Agent einbetten: Erfahren Sie, wie Bereichsautoren einen Iframe-Einbettungscode generieren und in eine externe Anwendung einfügen können. Siehe "Einbetten eines Genie-Agents" in einer externen App.
• Erstellen und Veröffentlichen von Dashboards: Erfahren Sie, wie Sie KI/BI-Dashboards zum Einbetten erstellen, konfigurieren und veröffentlichen. Siehe Dashboards.
• Verwalten von Arbeitsbereichssicherheitseinstellungen: Konfigurieren Sie zusätzliche Sicherheitseinstellungen und Zugriffssteuerungen für Ihren Arbeitsbereich. Siehe "Arbeitsbereich verwalten".