Tutorial: Einbetten von Power BI-Inhalten mit der Beispielanwendung Einbetten für Ihre Kunden

GILT FÜR: Die App besitzt die Daten Der Benutzer besitzt die Daten

Mit Embedded Analytics und Power BI Embedded (Azure-Angebot) können Sie Power BI-Inhalte wie Berichte, Dashboards und Kacheln in Ihre Anwendung einbetten.

In diesem Tutorial lernen Sie Folgendes:

  • Einrichten der eingebetteten Umgebung.
  • Konfigurieren der Beispielanwendung Einbetten für Ihre Kunden (auch als App Owns Data bezeichnet).

Benutzer müssen sich weder bei Power BI anmelden noch über eine Power BI-Lizenz verfügen, um Ihre Anwendung verwenden zu können.

Wenn Sie ein unabhängiger Softwareanbieter oder Entwickler sind, der Anwendungen für Dritte erstellen möchte, sollten Sie zum Einbetten der Power BI-Inhalte die Methode Einbetten für Ihre Kunden verwenden.

Wichtig

Wenn Sie Inhalte für eine nationale/regionale Cloud einbetten, sind die ersten Schritte dieses Tutorials anders. Weitere Informationen finden Sie unter Inhalte für nationale/regionale Clouds einbetten.

Spezifikationen für Codebeispiele

Dieses Tutorial enthält Anweisungen zum Konfigurieren der Beispielanwendung Einbetten für Ihre Kunden in einer der folgenden Frameworks:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

Die folgenden Browser werden von den Codebeispielen unterstützt:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Voraussetzungen

Vergewissern Sie sich vor Beginn dieses Tutorials, dass die im Folgenden aufgeführten Power BI- und Codeabhängigkeiten vorhanden sind:

Methode

Gehen Sie wie folgt vor, um die Beispielanwendung Einbetten für Ihre Kunden zu erstellen:

  1. Wählen Sie die Authentifizierungsmethode aus.

  2. Registrieren einer Microsoft Entra-App.

  3. Erstellen Sie einen Power BI-Arbeitsbereich.

  4. Erstellen Sie einen Power BI-Bericht, und veröffentlichen Sie ihn.

  5. Rufen Sie die Werte für den Einbettungsparameter ab.

  6. API-Zugriff des Dienstprinzipals

  7. Aktivieren Sie den Arbeitsbereichszugriff.

  8. Betten Sie die Inhalte ein.

Schritt 1: Auswählen der Authentifizierungsmethode

Die eingebettete Lösung variiert je nach der ausgewählten Authentifizierungsmethode. Daher ist es wichtig, dass Sie die Unterschiede zwischen den Authentifizierungsmethoden kennen, damit Sie entscheiden können, welche für Ihre Lösung am besten geeignet ist.

In der folgenden Tabelle werden einige entscheidende Unterschiede zwischen den Authentifizierungsmethoden Dienstprinzipal und Hauptbenutzer beschrieben.

Aspekt Dienstprinzipal Hauptbenutzer
Mechanismus Mit dem Dienstprinzipalobjekt der Microsoft Entra-App kann die App über Microsoft Entra ID mit der eingebetteten Lösung bei Power BI authentifiziert werden. Für die Authentifizierung bei Power BI werden von der Microsoft Entra-App die Anmeldeinformationen (Benutzername und Kennwort) eines Power BI-Benutzers verwendet.
Sicherheit Dienstprinzipal ist die empfohlene Autorisierungsmethode für Microsoft Entra ID. Wenn Sie einen Dienstprinzipal verwenden, können Sie sich entweder mit einem Anwendungsgeheimnis oder einem Zertifikat authentifizieren.

In diesem Tutorial wird nur die Verwendung des Dienstprinzipals mit einem Anwendungsgeheimnis beschrieben. Informationen zum Einbetten mit Dienstprinzipal und Zertifikat finden Sie im Artikel Einbetten von Power BI-Inhalten mit Dienstprinzipal und Zertifikat.
Diese Authentifizierungsmethode ist nicht so sicher wie ein Dienstprinzipal. Sie müssen bei den Anmeldeinformationen (Benutzername und Kennwort) des Hauptbenutzers achtgeben. Machen Sie sie z. B. nicht in Ihrer eingebetteten Anwendung verfügbar, und ändern Sie das Kennwort regelmäßig.
Delegierte Microsoft Entra-ID-Berechtigungen Nicht erforderlich. Der Hauptbenutzer oder ein Administrator muss die Einwilligung erteilen, dass die App Zugriff auf Berechtigungen der Power BI-REST-API (auch als Bereiche bezeichnet) hat. Beispiel: Report.ReadWrite.All.
Zugriff auf den Power BI-Dienst Auf den Power BI-Dienst können Sie nicht mit einem Dienstprinzipal zugreifen. Verwenden Sie für den Zugriff auf den Power BI-Dienst die Anmeldeinformationen des Hauptbenutzers.
Lizenz Setzt keine Pro-Lizenz voraus. Sie können Inhalte aus einem Arbeitsbereich verwenden, bei dem Sie Mitglied oder Administrator sind. Erfordert eine Power BI Pro or Premium pro Benutzer (PPU)-Lizenz.

Schritt 2: Registrieren einer Microsoft Entra-App

Wenn Sie die Anwendung bei Microsoft Entra ID registrieren, haben Sie folgende Möglichkeiten:

Befolgen Sie die Anweisungen unter Registrieren Ihrer Anwendung, um Ihre Anwendung bei Microsoft Entra ID zu registrieren.

Hinweis

Vor dem Registrieren der Anwendung müssen Sie entscheiden, welche Authentifizierungsmethode verwendet werden soll: Dienstprinzipal oder Hauptbenutzer.

Schritt 3: Erstellen eines Power BI-Arbeitsbereichs

Bei Power BI werden Berichte, Dashboards und Kacheln in einem Arbeitsbereich verwaltet. Wenn Sie diese Elemente einbetten möchten, müssen Sie sie erstellen und in einen Arbeitsbereich hochladen.

Tipp

Wenn bereits ein Arbeitsbereich vorhanden ist, können Sie diesen Schritt überspringen.

Gehen Sie folgendermaßen vor, um einen Arbeitsbereich zu erstellen:

  1. Melden Sie sich bei Power BI an.

  2. Wählen Sie Arbeitsbereich aus.

  3. Wählen Sie Arbeitsbereich erstellen aus.

  4. Geben Sie dem Arbeitsbereich einen Namen, und wählen Sie Speichern aus.

Schritt 4: Erstellen und Veröffentlichen eines Power BI-Berichts

Im nächsten Schritt erstellen Sie einen Bericht und laden ihn in den Arbeitsbereich hoch. Mit Power BI Desktop können Sie Ihren eigenen Bericht erstellen und anschließend im Arbeitsbereich veröffentlichen. Sie können aber auch einen Beispielbericht in den Arbeitsbereich hochladen.

Tipp

Wenn bereits ein Arbeitsbereich mit einem Bericht vorhanden ist, können Sie diesen Schritt überspringen.

Führen Sie die folgenden Schritte aus, um einen Beispielbericht herunterzuladen und im Arbeitsbereich zu veröffentlichen:

  1. Öffnen Sie den GitHub-Ordner mit Power BI Desktop-Beispielen.

  2. Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner Samples Reports (Beispielberichte).

  4. Wählen Sie den Bericht aus, den Sie einbetten möchten, und veröffentlichen Sie ihn im Arbeitsbereich.

Schritt 5: Abrufen der Werte für den Einbettungsparameter

Zum Einbetten von Inhalten müssen Sie bestimmte Parameterwerte abrufen. In der folgenden Tabelle sind die erforderlichen Werte aufgeführt, und es ist jeweils angegeben, ob die Werte für die Authentifizierungsmethode Dienstprinzipal, die Authentifizierungsmethode Hauptbenutzer oder für beide Authentifizierungsmethoden verwendet werden.

Vergewissern Sie sich vor dem Einbetten von Inhalten, dass alle im Folgenden aufgeführten Werte vorhanden sind. Einige Werte variieren je nach verwendeter Authentifizierungsmethode.

Parameter Dienstprinzipal Hauptbenutzer
Client-ID Applies to. Applies to.
Arbeitsbereichs-ID Applies to. Applies to.
Berichts-ID Applies to. Applies to.
Geheimer Clientschlüssel Applies to. Does not apply to.
Tenant ID Applies to. Nur für Node JS erforderlich
Power BI-Benutzername Does not apply to. Applies to.
Power BI-Kennwort Does not apply to. Applies to.

Client-ID

Tipp

Gilt für:Applies to.Dienstprinzipal Applies to.Master-Benutzer

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Client-ID (auch als Anwendungs-ID bezeichnet) abzurufen:

  1. Melden Sie sich bei Microsoft Azure an.

  2. Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.

  3. Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.

  4. Kopieren Sie im Abschnitt Übersicht den eindeutigen Bezeichner Anwendungs-ID (Client) .

Arbeitsbereichs-ID

Tipp

Gilt für:Applies to.Dienstprinzipal Applies to.Master-Benutzer

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Arbeitsbereichs-ID abzurufen:

  1. Melden Sie sich beim Power BI-Dienst an.

  2. Öffnen Sie den Bericht, den Sie einbetten möchten.

  3. Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /groups/ und /reports/ .

    A screenshot showing workspace ID GUID in the Power B I service U R L

Alternativ können Sie die Arbeitsbereichs-ID auch in den Einstellungen des Verwaltungsportals finden, indem Sie neben dem Arbeitsbereichsnamen Details auswählen.

A screenshot showing how to find the workspace I D from the admin settings.

Berichts-ID

Tipp

Gilt für:Applies to.Dienstprinzipal Applies to.Master-Benutzer

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Berichts-ID abzurufen:

  1. Melden Sie sich beim Power BI-Dienst an.

  2. Öffnen Sie den Bericht, den Sie einbetten möchten.

  3. Kopieren Sie den eindeutigen Bezeichner aus der URL. Der eindeutige Bezeichner ist die Zahl zwischen /reports/ und /ReportSection/ .

    A screenshot showing report ID GUID in the Power B I service U R L

Geheimer Clientschlüssel

Tipp

Gilt für:Applies to.Dienstprinzipal Does not apply to.Master-Benutzer

Gehen Sie wie folgt vor, um den geheimen Clientschlüssel abzurufen:

  1. Melden Sie sich bei Microsoft Azure an.

  2. Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.

  3. Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.

  4. Wählen Sie unter Verwalten die Option Zertifikate und Geheimnisse aus.

  5. Wählen Sie unter Geheime Clientschlüssel die Option Neuer geheimer Clientschlüssel.

  6. Geben Sie im Popupfenster Geheimen Clientschlüssel hinzufügen eine Beschreibung für den geheimen Anwendungsschlüssel ein, wählen Sie für den geheimen Anwendungsschlüssel ein Ablaufdatum aus, und klicken Sie auf Hinzufügen.

  7. Kopieren Sie im Abschnitt Geheime Clientschlüssel die Zeichenfolge in der Spalte Wert des neu erstellten geheimen Anwendungsschlüssels. Der Wert des geheimen Clientschlüssels ist die Client-ID.

Hinweis

Stellen Sie sicher, dass Sie den Wert des geheimen Clientschlüssels kopieren, wenn er zum ersten Mal angezeigt wird. Wenn Sie diese Seite verlassen, wird der geheime Clientschlüssel ausgeblendet, und Sie können den Wert nicht mehr abrufen.

Mandanten-ID

Tipp

Gilt für:Applies to.Dienstprinzipal Does not apply to.Master-Benutzer

Gehen Sie wie folgt vor, um den eindeutigen Bezeichner der Mandanten-ID abzurufen:

  1. Melden Sie sich bei Microsoft Azure an.

  2. Suchen Sie nach App-Registrierungen, und wählen Sie den Link App-Registrierungen aus.

  3. Wählen Sie die Microsoft Entra-App aus, die Sie zum Einbetten Ihrer Power BI-Inhalte verwenden.

  4. Kopieren Sie im Abschnitt Übersicht den eindeutigen Bezeichner Verzeichnis-ID (Mandant) .

Benutzername und Kennwort für Power BI

Tipp

Gilt für:Does not apply to.Dienstprinzipal Applies to.Master-Benutzer

Rufen Sie den Benutzernamen und das Kennwort des Power BI-Benutzers ab, den Sie als Hauptbenutzer verwenden. Dabei handelt es sich um denselben Benutzer, den Sie zum Erstellen eines Arbeitsbereichs und zum Hochladen eines Berichts im Power BI-Dienst verwendet haben.

Schritt 6: API-Zugriff des Dienstprinzipals

Tipp

Gilt für:Applies to.Dienstprinzipal Does not apply to.Master-Benutzer

Dieser Schritt ist nur relevant, wenn Sie die Authentifizierungsmethode Dienstprinzipal verwenden. Wenn Sie einen Hauptbenutzer verwenden, überspringen Sie diesen Schritt und fahren mit Schritt 7: Aktivieren des Arbeitsbereichszugriffs fort.

Damit eine Microsoft Entra-App auf die Power BI-Inhalte und -APIs zugreifen kann, muss ein*e Power BI-Administrator*in den Dienstprinzipalzugriff im Power BI-Verwaltungsportal aktivieren. Wenn Sie nicht der Administrator Ihres Mandanten sind, bitten Sie den Administrator des Mandanten, die Mandanteneinstellungen zu aktivieren.

  1. Wählen Sie in Power BI-DienstEinstellungen>Einstellungen>Verwaltungsportal aus.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Wählen Sie Mandanteneinstellungen aus, und scrollen Sie nach unten zum Abschnitt Entwicklereinstellungen.

  3. Klappen Sie Dienstprinzipalen die Verwendung von Power BI-APIs gestatten, und aktivieren Sie diese Option.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Hinweis

Wenn Sie einen Dienstprinzipalverwenden, sollten Sie dessen Zugriff auf die Mandanteneinstellungen mit einer Sicherheitsgruppebegrenzen. Weitere Informationen zu diesem Feature finden Sie in den folgenden Abschnitten des Artikels zum Dienstprinzipal:

Schritt 7: Aktivieren des Arbeitsbereichszugriffs

Fügen Sie dem Arbeitsbereich den/die Dienstprinzipal*in oder Hauptbenutzer*in als Mitglied oder Administrator*in hinzu, um Microsoft Entra-App-Zugriffsobjekte wie Berichte, Dashboards und semantische Modelle im Power BI-Dienst zu aktivieren.

  1. Melden Sie sich beim Power BI-Dienst an.

  2. Scrollen Sie zu dem Arbeitsbereich, für den Sie den Zugriff aktivieren möchten, und wählen Sie im Menü Mehr die Option Arbeitsbereichszugriff aus.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. Je nachdem, welche Authentifizierungsmethode Sie verwendeten, kopieren Sie im Bereich Zugriff den Dienstprinzipal oder den Hauptbenutzer in das Textfeld E-Mail-Adresse eingeben.

    Hinweis

    Wenn Sie eine/n Dienstprinzipal*in verwenden, hat dieser den Namen, den Sie Ihrer Azure AD-App gegeben haben.

  4. Wählen Sie Hinzufügen aus.

Schritt 8: Einbetten der Inhalte

Mit der eingebetteten Power BI-Beispielanwendung können Sie die Power BI-App Einbetten für Ihre Kunden erstellen.

Gehen Sie wie folgt vor, um die Beispielanwendung Einbetten für Ihre Kunden zu ändern und den Power BI-Bericht einzubetten.

  1. Öffnen Sie den Ordner Beispiele für Power BI für Entwickler.

  2. Wählen Sie Code und dann Download ZIP (ZIP herunterladen) aus.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Extrahieren Sie die heruntergeladene ZIP-Datei, und navigieren Sie zum Ordner PowerBI-Developer-Samples-master.

  1. Öffnen Sie einen der folgenden Ordner, je nachdem, welche Sprache für Ihre App verwendet werden soll:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Hinweis

    Von den Beispielanwendungen Einbetten für Ihre Kunden werden nur die oben genannten Frameworks unterstützt. Von der Beispielanwendung React wird nur die Lösung Einbetten für Ihre Organisation unterstützt.

  2. Öffnen Sie den Ordner Einbetten für Ihre Kunden.

  1. Öffnen Sie die Beispielanwendung „Einbetten für Ihre Kunden“ mit einer der folgenden Methoden:

  2. Öffnen Sie appsettings.json.

  3. Geben Sie je nach Authentifizierungsmethode die folgenden Parameterwerte ein:

    Parameter Dienstprinzipal Hauptbenutzer
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Die Client-ID Ihrer Microsoft Entra-App Die Client-ID Ihrer Microsoft Entra-App
    TenantId Ihre Microsoft Entra-Mandant*inen-ID
    PbiUsername Den Benutzernamen des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
    PbiPassword Das Kennwort des Hauptbenutzers finden Sie unter Benutzername und Kennwort für Power BI.
    ClientSecret Der geheime Clientschlüssel Ihrer Microsoft Entra-App N/V
    WorkspaceId Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID. Die ID des Arbeitsbereichs mit dem eingebetteten Bericht finden Sie unter Arbeitsbereichs-ID.
    ReportId Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID. Die ID des Berichts, den Sie einbetten, finden Sie unter Berichts-ID.
  4. Führen Sie das Projekt aus, indem Sie die entsprechende Option auswählen:

    • Wenn Sie Visual Studio verwenden, wählen Sie IIS Express (Wiedergabe) aus.

    • Wenn Sie Visual Studio-Code verwenden, wählen Sie Ausführen > Debugging starten.

Entwickeln Ihrer Anwendung

Nachdem Sie die Beispielanwendung Einbetten für Ihre Kunden konfiguriert und ausgeführt haben, können Sie mit der Entwicklung der eigenen Anwendung beginnen.

Testen Sie den Analysen-Playground von Power BI Embedded, um mit der Entwicklung zu beginnen und über alle neuen Power BI Embedded-Features und -Updates auf dem Laufenden zu bleiben.

Wenn Sie bereit sind, informieren Sie sich über die Anforderungen unter In die Produktionsphase wechseln. Zudem benötigen Sie eine Kapazität und sollten den Artikel Kapazitätsplanung lesen, um zu entscheiden, welche SKU für Ihre Anforderungen am besten geeignet ist.

Wichtig

Wenn Sie kostenlose Testtoken für die Entwicklung verwendet haben, müssen Sie für die Produktion Kapazitäten erwerben. Bis zum Erwerb einer Kapazität wird das Banner der kostenlosen Testversion weiterhin oben im eingebetteten Bericht angezeigt.

Weitere Fragen? Fragen an die Power BI-Community