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

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.

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 Sie eine Azure AD-Anwendung.

  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 Azure AD-App kann die App über Azure AD mit der eingebetteten Lösung bei Power BI authentifiziert werden. Für die Authentifizierung bei Power BI werden von der Azure AD-App die Anmeldeinformationen (Benutzername und Kennwort) eines Power BI-Benutzers verwendet.
Sicherheit Dienstprinzipal ist die empfohlene Autorisierungsmethode für Azure AD. Wenn Sie einen Dienstprinzipal verwenden,* ist die Authentifizierung mit einem geheimen Anwendungsschlüssel oder mit einem Zertifikat möglich.

In diesem Tutorial wird nur die Verwendung eines Dienstprinzipals mit einem geheimen Anwendungsschlüssel beschrieben. Informationen zum Einbetten mit Dienstprinzipal und Zertifikat finden Sie im Artikel Einbetten von Power BI-Inhalten mit Dienstprinzipal und Zertifikat.
Diese Authentifizierungsmethode gilt im Vergleich zur Verwendung eines Dienstprinzipals als weniger sicher. Das liegt daran, dass Sie bei den Anmeldeinformationen (Benutzername und Kennwort) des Hauptbenutzers achtgeben müssen. Diese dürfen Sie beispielsweise in der einbetteten Anwendung nicht verfügbar machen. Zudem müssen Sie das Kennwort regelmäßig ändern.
Delegierte Berechtigungen für Azure AD 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 Azure AD-Anwendung

Wenn Sie die Anwendung bei Azure AD registrieren, haben Sie folgende Möglichkeiten:

Befolgen Sie die Anweisungen unter Registrieren Ihrer Anwendung, um Ihre Anwendung 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.

    Screenshot: Option zum Herunterladen der ZIP im GitHub-Ordner mit Power BI Desktop-Beispielen

  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 Gilt für: Gilt für:
Arbeitsbereichs-ID Gilt für: Gilt für:
Berichts-ID Gilt für: Gilt für:
Geheimer Clientschlüssel Gilt für: Gilt nicht für:
Tenant ID Gilt für: Gilt nicht für:
Power BI-Benutzername Gilt nicht für: Gilt für:
Power BI-Kennwort Gilt nicht für: Gilt für:

Client-ID

Tipp

Gilt für: Gilt für:Dienstprinzipal Gilt für:Hauptbenutzer

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 Azure AD-App aus, die Sie zum Einbetten von Power BI-Inhalten verwenden.

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

Arbeitsbereichs-ID

Tipp

Gilt für: Gilt für:Dienstprinzipal Gilt für:Hauptbenutzer

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/ .

    Screenshot: Eindeutiger Bezeichner der Arbeitsbereichs-ID in der URL zum Power BI-Dienst

Berichts-ID

Tipp

Gilt für: Gilt für:Dienstprinzipal Gilt für:Hauptbenutzer

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/ .

    Screenshot: Eindeutiger Bezeichner der Berichts-ID in der URL zum Power BI-Dienst

Geheimer Clientschlüssel

Tipp

Gilt für: Gilt für:Dienstprinzipal Gilt nicht für:Hauptbenutzer

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 Azure AD-App aus, die Sie zum Einbetten von Power BI-Inhalten 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: Gilt für:Dienstprinzipal Gilt nicht für:Hauptbenutzer

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 Azure AD-App aus, die Sie zum Einbetten von Power BI-Inhalten verwenden.

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

Benutzername und Kennwort für Power BI

Tipp

Gilt für: Gilt nicht für:Dienstprinzipal Gilt für:Hauptbenutzer

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: Gilt für:Dienstprinzipal Gilt nicht für:Hauptbenutzer

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 Azure AD-App auf die Power BI-Inhalte und -APIs zugreifen kann, muss ein Power BI-Administrator 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-Dienst Einstellungen > Einstellungen > Verwaltungsportal aus.

    Screenshot: Menüoption mit Verwaltungseinstellungen im Menü mit Power BI-Diensteinstellungen

  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.

    Screenshot: Aktivieren der Option „Entwicklereinstellungen“ in der Menüoption „Mandanteneinstellungen“ in Power BI-Dienst

Hinweis

Wenn Sie einen Dienstprinzipal verwenden, sollten Sie dessen Zugriff auf die Mandanteneinstellungen mit einer Sicherheitsgruppe begrenzen. 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 Dienstprinzipal oder Hauptbenutzer als Mitglied oder Administrator hinzu, um Azure AD App-Zugriffsartefakte wie Berichte, Dashboards und Datasets 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 der Schaltfläche „Arbeitsbereichszugriff“ im Menü „Mehr“ eines Power BI-Arbeitsbereichs

  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 einen Dienstprinzipal 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.

    Screenshot: Option zum Herunterladen der ZIP im GitHub-Ordner mit Beispielen für Power BI für Entwickler

  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 Anwendung 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 Client-ID der Azure AD-App Client-ID der Azure AD-App
    TenantId Mandanten-ID der Azure AD-App
    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 Geheimer Clientschlüssel der Azure AD-App
    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 > Debuggen starten aus.

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.

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.

Nächste Schritte