Узнайте, как зарегистрировать приложение в Azure Active Directory (Azure AD) для использования внедренного содержимого Power BI.

Чтобы предоставить приложению доступ к интерфейсам REST API Power BI, его необходимо зарегистрировать в Azure AD. Это позволит установить удостоверение для приложения и указать разрешения на ресурсы REST 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. Нажмите кнопку Sign in with your existing account (Войти по существующей учетной записи).

  3. Введите значение в поле App Name (Имя приложения).

  4. Выбор типа приложения будет зависеть от используемого типа приложения.

    • Укажите Server-side Web app (Серверное веб-приложение) для веб-приложений или интерфейсов веб-API.
    • Укажите Native app (Собственное приложение) для приложений, работающих на клиентских устройствах. Также следует выбрать Native app (Собственное приложение) при внедрении содержимого пользователей, не использующих Power BI, вне зависимости от фактического типа приложения.
  5. Введите значения в полях Redirect URL (URL-адрес перенаправления) и Home Page URL (URL-адрес домашней страницы). Подойдет любой допустимый URL-адрес.

    Примечание.

    Поле Home Page URL (URL-адрес домашней страницы) доступно только, если вы выбрали тип приложения Server-side Web app (Серверное веб-приложение).

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

  7. Нажмите кнопку Register App (Зарегистрировать приложение).

    Вам будет предоставлен идентификатор клиента. Если вы выбрали Server-side Web app (Серверное веб-приложение), то вы также получите секрет клиента. При необходимости эти значения можно будет получить на портале Azure.

Теперь зарегистрированное приложение можно использовать как часть настраиваемого приложения для взаимодействия со службой Power BI.

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

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

  1. Примите условия использования API Microsoft Power BI.

  2. Войдите на портал Azure.

  3. Выберите клиент Azure AD, выбрав свою учетную запись в правом верхнем углу страницы.

  4. На левой панели навигации выберите Больше служб, выберите Регистрация приложений и щелкните Регистрация нового приложения.

  5. Следуя инструкциям на экране, создайте приложение.

    • Для веб-приложений укажите URL-адрес входа, который является базовым URL-адресом приложения, используемым пользователями для входа, например http://localhost:12345.
    • Для собственных приложений укажите универсальный код ресурса (URI) перенаправления, который Azure AD использует для возвращения ответов для токенов. Введите значение, относящимся к вашему приложению, например http://MyFirstAADApp.

Дополнительные сведения о регистрации приложений в Azure Active Directory см. в разделе Интеграция приложений с Azure Active Directory.

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

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

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

  1. Войдите на портал Azure.

  2. Выберите клиент Azure AD, выбрав свою учетную запись в правом верхнем углу страницы.

  3. На левой панели навигации выберите Больше служб и щелкните Регистрация приложений.

  4. Выберите приложение, для которого необходимо получить идентификатор клиента.

  5. Отобразятся идентификатор приложения и GUID. Это идентификатор клиента для приложения.

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

Внедрение в Power BI
Как внедрять панели мониторинга, отчеты и плитки Power BI
Разрешения Power BI
Создание клиента Azure Active Directory

Появились дополнительные вопросы? Попробуйте задать вопрос в сообществе Power BI.