Erfahren Sie, wie Sie eine Anwendung zum Einbetten von Power BI-Inhalten in Azure Active Directory (Azure AD) registrieren können.

Sie registrieren Ihre Anwendung bei Azure AD, um der Anwendung den Zugriff auf die Power BI-REST-APIs zu ermöglichen. Auf diese Weise können Sie eine Identität für Ihre Anwendung erstellen und Berechtigungen für Power BI-REST-Ressourcen angeben.

Wichtig:

Um eine Power BI-App zu registrieren, benötigen Sie einen Azure Active Directory-Mandanten und einen Organisationsbenutzer. Wenn Sie sich nicht bei einem Benutzer in Ihrem Mandanten für Power BI registriert haben, wird die Registrierung der App nicht ordnungsgemäß abgeschlossen.

Die Registrierung Ihrer Anwendung kann auf zweierlei Weise erfolgen. Erstens mithilfe des Power BI-App-Registrierungs-Tools, zweitens direkt im Azure-Portal. Das Power BI-App-Registrierungstool ist die einfachste Option, da nur wenige Felder ausgefüllt werden müssen. Wenn Sie Änderungen an der App vornehmen möchten, können Sie dies im Azure-Portal erledigen.

Registrieren mithilfe des Power BI-App-Registrierungs-Tools

Sie müssen Ihre Anwendung in Azure Active Directory registrieren, um eine Identität für Ihre Anwendung einzurichten und Berechtigungen für Power BI-REST-Ressourcen festzulegen. Wenn Sie eine Anwendung registrieren, etwa eine Konsolenanwendung oder eine Website, erhalten Sie eine ID, die von der Anwendung verwendet wird, um sich gegenüber den Benutzern zu identifizieren, bei denen sie Berechtigungen anfordert.

So registrieren Sie Ihre Anwendung mit dem Power BI-App-Registrierungs-Tool:

  1. Öffnen Sie die Seite dev.powerbi.com/apps.

  2. Wählen Sie Mit vorhandenem Konto anmelden aus.

  3. Geben Sie einen App-Namen an.

  4. Die Auswahl des App-Typs hängt vom Typ der verwendeten Anwendung ab.

    • Verwenden Sie Serverseitige Web-App für Web-Apps oder Web-APIs.
    • Verwenden Sie Native App für Apps, die auf Clientgeräten ausgeführt werden. Sie müssen Native App auch auswählen, wenn Sie Inhalte für Benutzer ohne Power BI einbetten, unabhängig von der tatsächlich verwendeten Anwendung.
  5. Geben Sie einen Wert für Umleitungs-URL und URL der Startseite ein. Jede gültige URL ist zulässig.

    Hinweis:

    URL der Startseite steht nur zur Verfügung, wenn Sie als Anwendungstyp Serverseitige Web-App ausgewählt haben.

  6. Wählen Sie die APIs aus, auf die diese Anwendung Zugriff haben soll. Weitere Informationen zu Power BI-Zugriffsberechtigungen finden Sie unter Power BI-Berechtigungen.

  7. Wählen Sie App registrieren aus.

    Sie erhalten dann eine Client-ID. Wenn Sie Serverseitige Web-App ausgewählt haben, erhalten Sie außerdem einen geheimen Clientschlüssel. Diese können bei Bedarf später aus dem Azure-Portal abgerufen werden.

Jetzt können Sie die registrierte Anwendung als Teil Ihrer benutzerdefinierten Anwendung verwenden, um die Interaktion mit dem Power BI-Dienst zu implementieren.

Registrieren beim Azure-Portal

Die andere Möglichkeit zum Registrieren Ihrer Anwendung besteht direkt im Azure-Portal. Führen Sie die folgenden Schritte aus, um Ihre Anwendung zu registrieren.

  1. Akzeptieren Sie die Nutzungsbedingungen für die Microsoft Power BI-API.

  2. Melden Sie sich beim Azure-Portal an.

  3. Wählen Sie Ihren Azure AD-Mandanten aus, indem Sie Ihr Konto in der oberen rechten Ecke der Seite auswählen.

  4. Wählen Sie im Navigationsbereich auf der linken Seite Weitere Dienste, dann App-Registrierungen und schließlich Neue Anwendungsregistrierung aus.

  5. Folgen Sie den Anweisungen, und erstellen Sie eine neue Anwendung .

    • Geben Sie für Webanwendungen die Anmelde-URL an. Dabei handelt es sich um die Basis-URL Ihrer App, bei der sich die Benutzer anmelden können, z.B. „http://localhost:12345“.
    • Geben Sie für native Anwendungen einen Umleitungs-URI an, den Azure AD zur Rückgabe von Tokenantworten verwendet. Geben Sie einen für Ihre Anwendung spezifischen Wert ein, z.B. „http://MyFirstAADApp“.

Weitere Informationen zum Registrieren von Anwendungen in Azure Active Directory finden Sie unter Integrieren von Anwendungen in Azure Active Directory

Abrufen der Client-ID

Beim Registrieren einer Anwendung erhalten Sie eine Client-ID. Die Anwendung identifiziert sich mithilfe der Client-ID bei den Benutzern, von denen sie Berechtigungen anfordert.

So rufen Sie eine Client-ID ab:

  1. Melden Sie sich beim Azure-Portal an.

  2. Wählen Sie Ihren Azure AD-Mandanten aus, indem Sie Ihr Konto in der oberen rechten Ecke der Seite auswählen.

  3. Wählen Sie im Navigationsbereich auf der linken Seite Weitere Dienste und dann App-Registrierungen aus.

  4. Wählen Sie die Anwendung aus, für die Sie die Client-ID abrufen möchten.

  5. Sie sehen Anwendungs-ID zusammen mit einer GUID aufgelistet. Dies ist die Client-ID der Anwendung.

Nächste Schritte

Einbetten mit Power BI
Einbetten von Power BI-Dashboards, -Berichten und -Kacheln
Power BI-Berechtigungen
Erstellen eines Azure Active Directory-Mandanten

Weitere Fragen? Stellen Sie Ihre Frage in der Power BI-Community.