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

Ниже описана процедура регистрации веб-приложения с помощью средства регистрации приложений Power BI:

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

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

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

  • Имя приложения: имя приложения.
  • Тип приложения: выберите собственное приложение.
  • URI перенаправления:для веб-приложения URI перенаправления позволяет AAD получить дополнительную информацию о конкретном приложении, для которого будет выполнена проверка подлинности. Пример универсального кода ресурса (URI) перенаправления выглядит следующим образом: http://localhost/redirect.
  • Домашняя страница:домашняя страница или страница входа для веб-приложения.

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

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

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

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

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

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

Вот как можно зарегистрировать клиентское приложение:

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

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

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

  7. На странице Расскажите о своем приложениивведите Имяи выберите тип Веб-приложение и/или веб-API , а затем щелкните значок Далее .

  8. На странице Свойства приложения введите URL-АДРЕС ВХОДА и URI кода приложения. URL-АДРЕС ВХОДА — это URL-адрес приложения, например https://localhost:44307. URI КОДА ПРИЛОЖЕНИЯ — это универсальный код ресурса (URI) клиента Azure плюс имя вашего приложения. Пример: https://yourtenant.onmicrosoft.com/YourWebApp.

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

  10. На странице приложений выберите Конфигурация. На странице НАСТРОЙКА имеется Идентификатор клиента и Ключ для вашего приложения.

    Шаг 10

  11. Для веб-приложения необходим секретный ключ клиента. В разделе Ключи выберите длительность. Ключ отобразится после его сохранения. Обязательно скопируйте ключ. В противном случае он будет недоступен при переходе на страницу конфигурации в будущем.

  12. На странице КОНФИГУРАЦИЯ щелкните Добавить приложение.

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

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

  14. Щелкните значок Завершить, расположенный в правом нижнем углу страницы.

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

  16. Нажмите Сохранить.

    ** Важно! ** Для веб-приложения необходим секретный ключ клиента. Этот секретный ключ отобразится после его сохранения. Обязательно скопируйте ключ. В противном случае он будет недоступен при переходе на страницу конфигурации в будущем.

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

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

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

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

    Шаг 1.3

Как получить секрет клиента

Для веб-приложения необходим секретный ключ клиента. Azure AD создает ключ при регистрации веб-приложения (см. шаг 11 выше). В разделе Ключи выберите длительность. Ключ отобразится после его сохранения. Обязательно скопируйте ключ. В противном случае он будет недоступен при переходе на страницу конфигурации в будущем.

См. также:

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