Шаг 2. Получение токена доступа для проверки подлинностиStep 2: Get an authentication access token

Эта статья является частью пошагового руководства по принудительной отправке данных в набор данных.This article is part of a step-by-step walkthrough to push data into a dataset.

На шаге 1 (Регистрация приложения в Azure AD) руководства по принудительной отправке данных в набор данных вы зарегистрировали клиентское приложение в Azure AD.In step 1 of Push data into a dataset, Register the app with Azure AD, you registered a client app in Azure AD. На этом шаге вы получите токен доступа для проверки подлинности.In this step, you get an authentication access token. Приложения Power BI интегрированы с Azure AD для обеспечения безопасного входа и авторизации в приложении.Power BI apps are integrated with Azure AD to provide secure sign in and authorization for your app. Токен используется для проверки подлинности в Azure AD и получения доступа к ресурсам Power BI.You use a token to authenticate to Azure AD and gain access to Power BI resources.

Далее приведены действия по получению токена.Here's how to get an authentication access token.

Получение токена доступа для проверки подлинностиGet an authentication access token

ПРИМЕЧАНИЕ. Перед началом работы убедитесь, что выполнены предыдущие шаги из пошагового руководства по принудительной отправке данных в набор данных.NOTE: Before you get started, make sure you have followed the previous steps in the push data into a dataset walkthrough.

  1. В Visual Studio 2015 создайте проект консольного приложения .In Visual Studio 2015, create a Console Application project.
  2. Установите библиотеку проверки подлинности Azure AD для пакета NuGet .NET.Install the Azure AD Authentication Library for .NET NuGet package. Этот пакет используется при получении токена безопасности для проверки подлинности в приложении .NET.To get an authentication security token in a .NET app, you use this package. Ниже приведены действия по установке пакета.Here's how to install the package:

    а.a. В Visual Studio 2015 выберите пункты Сервис > Диспетчер пакетов NuGet > Консоль диспетчера пакетов.In Visual Studio 2015, choose Tools > NuGet Package Manager > Package Manager Console.

    б.b. В консоли диспетчера пакетоввведите команду Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612.In Package Manager Console, enter Install-Package Microsoft.IdentityModel.Clients.ActiveDirectory -Version 2.21.301221612.

  3. Добавьте приведенный ниже код в класс Program {...}.Add the code below into class Program {...}.
  4. Замените "{ClientID}" на идентификатор клиента, который вы получили при регистрации приложения.Replace "{ClientID}", with the Client ID you got when you registered the app. См. статью Регистрация приложения в Azure AD.See Register the app with Azure AD.
  5. После установки пакета Microsoft.IdentityModel.Clients.ActiveDirectory добавьте using Microsoft.IdentityModel.Clients.ActiveDirectory; в файл Program.cs.After installing the Microsoft.IdentityModel.Clients.ActiveDirectory package, add using Microsoft.IdentityModel.Clients.ActiveDirectory; to Program.cs.
  6. Запустите консольное приложение и войдите в свою учетную запись Power BI.Run the Console App, and login to your Power BI account. В окне консоли вы должны увидеть строку токена.You should see a token string in the Console Window.

Пример кода получения маркера безопасности для проверки подлинностиSample code to get authentication security token

Добавьте этот код в Program {...}.Add this code to Program {...}.

  • Переменная токена для вызова операций:A token variable to call operations:

    private static string token = string.Empty;
    
    static void Main(string[] args)
    {
    }
    
  • В методе static void Main(string[] args):In static void Main(string[] args):

    static void Main(string[] args)
    {
      //Get an authentication access token
      token = GetToken();
    }
    
  • Добавьте метод GetToken():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

Получив токен проверки подлинности, вы можете вызывать любые операции Power BI.After you get an authentication token, you can call any Power BI operation. Далее показано, как вызвать операцию Создание набора данных для создания набора данных, отправляемого в панель мониторинга.The next step shows you how to call the Create Dataset operation to create a dataset to push data into a dashboard.

На следующем шаге выполняются действия по созданию набора данных в Power BI.The next step shows you how to create a dataset in Power BI.

Ниже приведен полный листинг кода.Below is the complete code listing.

Полный листинг кодаComplete 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

    }
}

Дальнейшие действия >Next Step >

Дальнейшие действияNext steps

Создание набора данных в панели мониторинга Power BICreate a dataset in Power BI
Регистрация приложения в Azure ADRegister an app with Azure AD
Библиотека проверки подлинности Azure AD для пакета NuGet для .NETAzure AD Authentication Library for .NET NuGet package
Принудительная отправка данных в панель мониторинга Power BIPush data into a Power BI dataset
Обзор интерфейса REST API Power BIOverview of Power BI REST API
Справочник по REST API Power BIPower BI REST API reference
Появились дополнительные вопросы?More questions? Ответы на них см. в сообществе Power BI.Try the Power BI Community