В этой статье показано, как зарегистрировать клиентское приложение Power BI в Azure Active Directory (Azure AD). Чтобы предоставить приложению доступ к REST API Power BI, необходимо зарегистрировать приложение в Azure AD. Это позволит установить удостоверение для приложения и указать разрешения на ресурсы REST Power BI. Ознакомиться со списком разрешений Power BI можно в статье Разрешения Power BI.

Важно. Для регистрации приложения Power BI вам потребуется клиент Azure Active Directory и пользователь организации, а также учетная запись службы Power BI.

Существует два способа регистрации клиентского приложения: в средстве регистрации приложений Power BI и на портале управления Azure. Средство регистрации приложений Power BI — это наиболее простой вариант, поскольку в нем всего лишь несколько полей для заполнения. Если вы хотите внести в приложения какие-то изменения, это можно сделать через портал управления Azure.

В этой статье

Регистрация клиентского приложения с помощью средства регистрации приложений Power BI

Чтобы получить удостоверение для своего приложения и указать разрешения для ресурсов REST Power BI, необходимо зарегистрировать клиентское приложение в Azure Active Directory . При регистрации клиентского приложения, такого как консольное приложение, вы получаете код клиента. Идентификатор клиента используется приложением для идентификации себя пользователям, у которых запрашиваются разрешения. Ниже описана процедура регистрации клиентского приложения с помощью средства регистрации приложений Power BI:

  1. Перейдите по адресу dev.powerbi.com/apps.
  2. В средстве регистрации приложений Power BI выполните четыре указанных ниже действия.

Шаг 1. Выберите Вход для входа с использованием своей учетной записи Azure AD. Вы увидите свое имя в строке приветствия.

Шаг 2 — введите сведения о своем приложении.

  • Имя приложения: имя приложения.
  • Тип приложения: выберите собственное приложение.
  • URI перенаправления:для собственного клиентского приложения URI перенаправления позволяет AAD получить дополнительную информацию о конкретном приложении, для которого будет выполнена проверка подлинности. Подходит любой допустимый универсальный код ресурса (URI), например https://login.live.com/oauth20_desktop.srf.

Шаг 3. Выберите интерфейсы API для доступа. Дополнительные сведения о разрешениях доступа Power BI см. в статье Разрешения Power BI.

Шаг 4. Щелкните Зарегистрировать приложение, чтобы зарегистрировать приложение. После регистрации приложения в Azure AD вы получите идентификатор клиента. Не забудьте скопировать идентификатор клиента. Идентификатор клиента можно получить и позже на портале управления Azure. См. подраздел Как получить идентификатор клиентского приложения.

Теперь вы можете использовать идентификатор клиента для своего приложения. В следующем разделе показано, как зарегистрировать клиентское приложение на портале управления Azure.

Регистрация клиентского приложения на портале управления Azure

Чтобы получить удостоверение для своего приложения и указать разрешения для ресурсов REST Power BI, необходимо зарегистрировать клиентское приложение в Azure Active Directory . При регистрации клиентского приложения, такого как консольное приложение, вы получаете код клиента. Идентификатор клиента используется приложением для идентификации себя пользователям, у которых запрашиваются разрешения.

Чтобы узнать о том, как аутентифицировать клиентское приложение с помощью идентификатора клиента Azure AD, см. статью Аутентификация клиентского приложения.

Регистрация клиентского приложения

Вот как можно зарегистрировать клиентское приложение: 1. Примите условия использования API Microsoft Power BI. 2. Войдите с помощью подписки Microsoft Azure по адресу https://manage.windowsazure.com. 3. На панели служб слева выберите ACTIVE DIRECTORY. 4. Выберите службу Active Directory, к которой вы принадлежите.

  1. Нажмите Приложения.

  2. Нажмите Добавить.

  3. На странице Расскажите о своем приложениивведите ИМЯи выберите тип СОБСТВЕННОЕ КЛИЕНТСКОЕ ПРИЛОЖЕНИЕ , а затем нажмите значок Далее .

  4. На странице Сведения о приложениивведите URI ПЕРЕНАПРАВЛЕНИЯ. Для клиентского приложения URI перенаправления позволяет AAD получить дополнительную информацию о конкретном приложении, для которого будет выполнена аутентификация. Для клиентского приложения можно использовать любой допустимый универсальный код ресурса (URI), например https://login.live.com/oauth20_desktop.srf.

  5. Щелкните значок Завершить.

  6. На странице приложений выберите Конфигурация. Вы увидите ИДЕНТИФИКАТОР КЛИЕНТА.

  7. На странице КОНФИГУРАЦИЯ в разделе разрешений для других приложений нажмите Добавить приложение.

  8. В списке Разрешения для других приложений выберите Служба Power BI.

    Важно. Если вы не видите пункт Служба Power BI в списке Разрешения для других приложений, необходимо зарегистрироваться в службе Power BI. Чтобы зарегистрироваться в службе Power BI, необходим по крайней мере один пользователь организации в клиенте Azure Active Directory (AAD). Если у вас нет клиента Azure Active Directory (AAD), ознакомьтесь со статьей Создание клиента Azure Active Directory, чтобы создать клиент Azure AD и пользователя организации в клиенте Azure AD.

  9. Щелкните значок Завершить.

  10. В группе Разрешения для других приложений выберите все Делегированные разрешения и выберите одно или несколько разрешений. Дополнительные сведения о разрешениях Power BI см. в статье Разрешения Power BI.

  11. Щелкните Сохранить.

Как получить идентификатор клиентского приложения

При регистрации клиентского приложения (например, консольного приложения) вы получаете идентификатор клиента. Идентификатор клиента используется приложением для идентификации себя пользователям, у которых запрашиваются разрешения.

Вот как можно получить идентификатор клиента:

  1. Войдите с помощью подписки Microsoft Azure по адресу https://manage.windowsazure.com.
  2. На панели служб слева выберите ACTIVE DIRECTORY.
  3. Выберите службу Active Directory, к которой вы принадлежите.
  4. Нажмите Приложения.
  5. Выберите приложение.
  6. На странице приложений выберите Конфигурация.
  7. На странице Конфигурация скопируйте Идентификатор клиента.

См. также:

Разрешения Power BI
Клиент Azure Active Directory и пользователь организации
Учетная запись службы Power BI
Проверка подлинности клиентского приложения
Обзор интерфейса REST API Power BI
Появились дополнительные вопросы? Ответы на них см. в сообществе Power BI.