Schritt 2: Abrufen eines AuthentifizierungszugriffstokensStep 2: Get an authentication access token

Dieser Artikel ist Teil einer Anleitung zum Übertragen von Daten in ein Dataset per Push.This article is part of a step-by-step walkthrough to push data into a dataset.

In Schritt 1 von „Übertragen von Daten in ein Dataset per Push“ haben Sie unter Registrieren der App bei Azure AD eine Client-App in Azure AD registriert.In step 1 of Push data into a dataset, Register the app with Azure AD, you registered a client app in Azure AD. In diesem Schritt rufen Sie ein Authentifizierungszugriffstoken ab.In this step, you get an authentication access token. Power BI-Apps sind in Azure AD integriert, um eine sichere Anmeldung und Autorisierung Ihrer App zu ermöglichen.Power BI apps are integrated with Azure AD to provide secure sign in and authorization for your app. Sie verwenden ein Token für die Authentifizierung bei Azure AD und den Zugriff auf Power BI-Ressourcen.You use a token to authenticate to Azure AD and gain access to Power BI resources.

Nachstehend wird das Abrufen eines Authentifizierungszugriffstokens erläutert.Here's how to get an authentication access token.

Abrufen eines AuthentifizierungszugriffstokensGet an authentication access token

HINWEIS: Wichtig ist, dass Sie zuvor die vorangegangenen Schritten der exemplarischen Vorgehensweise Übertragen von Daten in ein Dataset per Push ausgeführt haben.NOTE: Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. Erstellen Sie in Visual Studio 2015 ein Projekt des Typs Konsolenanwendung .In Visual Studio 2015, create a Console Application project.
  2. Installieren Sie das NuGet-Paket mit der Azure AD-Authentifizierungsbibliothek für .NET.Install the Azure AD Authentication Library for .NET NuGet package. Verwenden Sie dieses Paket, um ein Authentifizierungssicherheitstoken in einer .NET-App abzurufen.To get an authentication security token in a .NET app, you use this package. Das Paket wird so installiert:Here's how to install the package:

    a.a. Wählen Sie in Visual Studio 2015 Tools > NuGet-Paket-Manager > Paket-Manager-Konsole.In Visual Studio 2015, choose Tools > NuGet Package Manager > Package Manager Console.

    b.b. Geben Sie der Paket-Manager-Konsole„Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory-Version 2.21.301221612“ ein.In Package Manager Console, enter Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612.

  3. Fügen Sie den folgenden Code „class Program {...}“ hinzu.Add the code below into class Program {...}.
  4. Ersetzen Sie „{ClientID}“ durch die Client-ID, die Sie beim Registrieren der App erhalten haben.Replace "{ClientID}", with the Client ID you got when you registered the app. Siehe Registrieren einer App in Azure AD.See Register the app with Azure AD.
  5. Fügen Sie nach der Installation des Pakets „Microsoft.IdentityModel.Clients.ActiveDirectory“ using Microsoft.IdentityModel.Clients.ActiveDirectory; zur Datei „Program.cs“ hinzu.After installing the Microsoft.IdentityModel.Clients.ActiveDirectory package, add using Microsoft.IdentityModel.Clients.ActiveDirectory; to Program.cs.
  6. Führen Sie die Konsolen-App aus, und melden Sie sich bei Ihrem Power BI-Konto an.Run the Console App, and login to your Power BI account. Daraufhin sollte im Konsolenfenster eine Tokenzeichenfolge angezeigt werden.You should see a token string in the Console Window.

Beispielcode zum Abrufen des AuthentifizierungssicherheitstokensSample code to get authentication security token

Fügen Sie diesen Code „Program {...}“ hinzu.Add this code to Program {...}.

  • Eine Tokenvariable zum Aufrufen von Vorgängen:A token variable to call operations:

    private static string token = string.Empty;
    
    static void Main(string[] args)
    {
    }
    
  • In „static void Main(string[]args)“:In static void Main(string[] args):

    static void Main(string[] args)
    {
      //Get an authentication access token
      token = GetToken();
    }
    
  • Eine „GetToken()“-Methode hinzu:Add a GetToken() method:
       #region Get an authentication access token
       private static string GetToken()
       {
           // TODO: Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612
           // and add using Microsoft.IdentityModel.Clients.ActiveDirectory

           //The client id that Azure AD created when you registered your client app.
           string clientID = "{Client_ID}";

           //RedirectUri you used when you register your app.
           //For a client app, a redirect uri gives Azure AD more details on the application that it will authenticate.
           // You can use this redirect uri for your client app
           string redirectUri = "https://login.live.com/oauth20_desktop.srf";

           //Resource Uri for Power BI API
           string resourceUri = "https://analysis.windows.net/powerbi/api";

           //OAuth2 authority Uri
           string authorityUri = "https://login.windows.net/common/oauth2/authorize";

           //Get access token:
           // To call a Power BI REST operation, create an instance of AuthenticationContext and call AcquireToken
           // AuthenticationContext is part of the Active Directory Authentication Library NuGet package
           // To install the Active Directory Authentication Library NuGet package in Visual Studio,
           //  run "Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory" from the nuget Package Manager Console.

           // AcquireToken will acquire an Azure access token
           // Call AcquireToken to get an Azure token from Azure Active Directory token issuance endpoint
           AuthenticationContext authContext = new AuthenticationContext(authorityUri);
           string token = authContext.AcquireToken(resourceUri, clientID, new Uri(redirectUri)).AccessToken;

           Console.WriteLine(token);
           Console.ReadLine();

           return token;
       }

       #endregion

Nach dem Abruf eines Authentifizierungstokens können Sie sämtliche Power BI-Vorgänge aufrufen.After you get an authentication token, you can call any Power BI operation. Im nächste Schritt erfahren Sie, wie Sie den Vorgang Dataset erstellen aufrufen, um ein Dataset zum Übertragen von Daten in ein Dashboard per Push zu erstellen.The next step shows you how to call the Create Dataset operation to create a dataset to push data into a dashboard.

Im nächsten Schritt wird das Erstellen eines Datasets in Power BI erläutert.The next step shows you how to create a dataset in Power BI.

Nachstehend finden Sie die vollständige Codeliste.Below is the complete code listing.

Vollständige CodelisteComplete code listing

using System;
using Microsoft.IdentityModel.Clients.ActiveDirectory;

namespace walkthrough_push_data
{
    class Program
    {
        private static string token = string.Empty;

        static void Main(string[] args)
        {

            //Get an authentication access token
            token = GetToken();

        }

        #region Get an authentication access token
        private static string GetToken()
        {
            // TODO: Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612
            // and add using Microsoft.IdentityModel.Clients.ActiveDirectory

            //The client id that Azure AD created when you registered your client app.
            string clientID = "{Client_ID}";

            //RedirectUri you used when you register your app.
            //For a client app, a redirect uri gives Azure AD more details on the application that it will authenticate.
            // You can use this redirect uri for your client app
            string redirectUri = "https://login.live.com/oauth20_desktop.srf";

            //Resource Uri for Power BI API
            string resourceUri = "https://analysis.windows.net/powerbi/api";

            //OAuth2 authority Uri
            string authorityUri = "https://login.windows.net/common/oauth2/authorize";

            //Get access token:
            // To call a Power BI REST operation, create an instance of AuthenticationContext and call AcquireToken
            // AuthenticationContext is part of the Active Directory Authentication Library NuGet package
            // To install the Active Directory Authentication Library NuGet package in Visual Studio,
            //  run "Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory" from the nuget Package Manager Console.

            // AcquireToken will acquire an Azure access token
            // Call AcquireToken to get an Azure token from Azure Active Directory token issuance endpoint
            AuthenticationContext authContext = new AuthenticationContext(authorityUri);
            string token = authContext.AcquireToken(resourceUri, clientID, new Uri(redirectUri)).AccessToken;

            Console.WriteLine(token);
            Console.ReadLine();

            return token;
        }

        #endregion

    }
}

Nächster Schritt >Next Step >

Nächste SchritteNext steps

Erstellen eines Datasets in Power BICreate a dataset in Power BI
Registrieren einer App in Azure ADRegister an app with Azure AD
NuGet-Paket mit der Azure AD-Authentifizierungsbibliothek für .NETAzure AD Authentication Library for .NET NuGet package
Übertragung von Daten in ein Power BI-Dataset per PushPush data into a Power BI dataset
Übersicht über Power BI-REST-APIOverview of Power BI REST API
Referenz zur Power BI-REST-APIPower BI REST API reference
Weitere Fragen?More questions? Wenden Sie sich an die Power BI-CommunityTry the Power BI Community