Руководство по внедрению содержимого Power BI с помощью примера внедрения для приложения клиентов
ОБЛАСТЬ ПРИМЕНЕНИЯ: Приложение владеет данными, принадлежащими пользователю данных
Внедренная аналитика и Power BI Embedded (предложение Azure) позволяют внедрять содержимое Power BI, например отчеты, панели мониторинга и плитки, в приложение.
В этом руководстве описано следующее:
- Настройте внедренную среду.
- Настройте внедрение для клиентов (также известных как данные, принадлежащие приложению) пример приложения.
Чтобы использовать приложение, пользователям не нужно входить в Power BI или иметь лицензию Power BI.
Мы рекомендуем использовать внедрение для клиентов для внедрения содержимого Power BI, если вы являетесь независимым поставщиком программного обеспечения (ISV) или разработчиком, который хочет создать приложения для третьих сторон.
Внимание
Если вы внедряете содержимое для национального или регионального облака, первые несколько шагов этого руководства отличаются. Дополнительные сведения см. в разделе "Внедрение содержимого" для национальных и региональных облаков .
Спецификации примеров кода
В этом руководстве содержатся инструкции по настройке внедрения для примера приложения для клиентов в одной из следующих платформ:
- .NET Framework
- .NET Core
- Java
- Node.js
- Python
Примеры кода поддерживают следующие браузеры:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Необходимые компоненты
Перед началом работы с этим руководством убедитесь, что у вас есть следующие зависимости Power BI и кода:
Зависимости Power BI
Собственный клиент Microsoft Entra.
Чтобы выполнить проверку подлинности приложения в Power BI, необходимо выполнить одно из следующих действий.
Субъект-служба — объект субъекта-службы Microsoft Entra, позволяющий идентификатору Microsoft Entra пройти проверку подлинности приложения.
Лицензия Power BI Pro — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.
Лицензия Power BI Premium на пользователя (PPU) — это главный пользователь , и приложение использует его для проверки подлинности в Power BI.
Примечание.
Для перехода в рабочую среду потребуется емкость.
Зависимости кода
Пакет SDK для .NET Core 3.1 (или более поздней версии)
Интегрированная среда разработки (IDE). Рекомендуется использовать одну из следующих сред:
Способ
Чтобы создать внедрение для примера приложения для клиентов , выполните следующие действия.
Выберите метод проверки подлинности.
Зарегистрируйте приложение Microsoft Entra.
Создайте рабочую область Power BI.
Создание и публикация отчета Power BI.
Получение значений параметров внедрения.
Включите доступ к рабочей области.
Шаг 1. Выбор метода проверки подлинности
Встроенное решение зависит от выбранного метода проверки подлинности. Поэтому важно понять различия между методами проверки подлинности и решить, какой из них лучше всего подходит для вашего решения.
В следующей таблице описано несколько ключевых различий между субъектом-службой и основными методами проверки подлинности пользователей.
Фактор | Субъект-служба | Главный пользователь |
---|---|---|
Механизм | Объект субъекта-службы приложения Microsoft Entra позволяет Идентификатору Microsoft Entra пройти проверку подлинности внедренного приложения решения в Power BI. | Приложение Microsoft Entra использует учетные данные (имя пользователя и пароль) пользователя Power BI для проверки подлинности в Power BI. |
Безопасность | Субъект-служба — это рекомендуемый метод авторизации идентификатора Microsoft Entra. Если вы используете субъект-службу, вы можете пройти проверку подлинности с помощью секрета приложения или сертификата. В этом руководстве описывается только использование субъекта-службы с секретом приложения. Чтобы внедрить субъект-службу и сертификат, обратитесь к субъекту-службе с помощью статьи сертификата. |
Этот метод проверки подлинности не является таким безопасным, как субъект-служба. Необходимо быть бдительным с учетными данными главного пользователя (имя пользователя и пароль). Например, не предоставляйте их в приложении внедрения и часто изменяйте пароль. |
Делегированные разрешения идентификатора Microsoft Entra | Необязательно. | Главный пользователь или администратор должен предоставить свое согласие на доступ к разрешениям REST API Power BI (также называемым область). Например, Report.ReadWrite.All. |
доступ служба Power BI | Доступ к служба Power BI с помощью субъекта-службы невозможно. | Вы можете получить доступ к служба Power BI с учетными данными главного пользователя. |
Лицензия | Не требуется лицензия Pro. Вы можете использовать содержимое из любой рабочей области, в которую вы являетесь членом или администратором. | Требуется лицензия Power BI Pro или Premium на пользователя (PPU). |
Шаг 2. Регистрация приложения Microsoft Entra
Регистрация приложения с помощью идентификатора Microsoft Entra позволяет:
- Установка удостоверения для приложения
- Предоставление приложению доступа к REST API Power BI
- Если вы используете основного пользователя . Укажите разрешения REST приложения Power BI
Чтобы зарегистрировать приложение с помощью идентификатора Microsoft Entra, следуйте инструкциям в разделе "Регистрация приложения".
Примечание.
Перед регистрацией приложения необходимо решить, какой метод проверки подлинности будет использоваться, субъект-служба или главный пользователь.
Шаг 3. Создание рабочей области Power BI
Power BI сохраняет отчеты, панели мониторинга и плитки в рабочей области. Чтобы внедрить эти элементы, необходимо создать их и отправить их в рабочую область.
Совет
Если у вас уже есть рабочая область, можно пропустить этот шаг.
Чтобы создать рабочую область, сделайте следующее:
Войдите в Power BI.
Выберите рабочие области.
Выберите Создать рабочую область.
Назовите рабочую область и нажмите кнопку "Сохранить".
Шаг 4. Создание и публикация отчета Power BI
Следующий шаг — создать отчет и отправить его в рабочую область. Вы можете создать собственный отчет с помощью Power BI Desktop, а затем опубликовать его в рабочей области. Кроме того, вы можете отправить пример отчета в рабочую область.
Совет
Если у вас уже есть рабочая область с отчетом, можно пропустить этот шаг.
Чтобы скачать пример отчета и опубликовать его в рабочей области, выполните следующие действия:
Откройте папку примеров GitHub Power BI Desktop.
Выберите "Код" и выберите "Скачать ZIP-файл".
Извлеките скачанный ZIP-файл и перейдите в папку "Отчеты примеров ".
Выберите отчет для внедрения и публикации в рабочей области.
Шаг 5. Получение значений параметров внедрения
Чтобы внедрить содержимое, необходимо получить определенные значения параметров. В следующей таблице показаны необходимые значения и указываются, применимы ли они к методу проверки подлинности субъекта-службы , методу проверки подлинности главного пользователя или обоим.
Перед внедрением содержимого убедитесь, что у вас есть все значения, перечисленные ниже. Некоторые значения могут отличаться в зависимости от используемого метода проверки подлинности.
Параметр | Субъект-служба | Главный пользователь |
---|---|---|
Идентификатор клиента | ||
Идентификатор рабочей области | ||
Идентификатор отчета | ||
Секрет клиента | ||
Идентификатор клиента | требуется только для JS узла | |
Имя пользователя Power BI | ||
Пароль Power BI |
Client ID
Совет
Применимо к:главному пользователю субъекта-службы
Чтобы получить ИДЕНТИФИКАТОР клиента (также известный как идентификатор приложения), выполните следующие действия:
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
Из раздела "Обзор" скопируйте ИДЕНТИФИКАТОР идентификатора приложения (клиента).
Идентификатор рабочей области
Совет
Применимо к:главному пользователю субъекта-службы
Чтобы получить GUID идентификатора рабочей области, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL-адреса. GUID — это число между /groups/ и /reports/.
Кроме того, можно найти идентификатор рабочей области в параметрах портала Администратор, выбрав "Сведения" рядом с именем рабочей области.
Код отчета
Совет
Применимо к:главному пользователю субъекта-службы
Чтобы получить guid идентификатора отчета, выполните следующие действия.
Выполните вход в службу Power BI.
Откройте отчет, который требуется внедрить.
Скопируйте GUID из URL-адреса. GUID — это число между /reports/ и /ReportSection.
Секрет клиента
Совет
Применимо к:главному пользователю субъекта-службы
Чтобы получить секрет клиента, выполните приведенные ниже действия.
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
В разделе Управление выберите Сертификаты и секреты.
В разделе Секреты клиента выберите Новый секрет клиента.
Во всплывающем окне "Добавление секрета клиента" укажите описание секрета приложения, выберите, когда срок действия секрета приложения истекает, и нажмите кнопку "Добавить".
Из раздела секретов клиента скопируйте строку в столбце Value созданного секрета приложения. Значение секрета клиента — это идентификатор клиента.
Примечание.
Скопируйте значение секрета клиента при первом появлении. После перехода от этой страницы секрет клиента будет скрыт, и вы не сможете получить его значение.
Идентификатор клиента
Совет
Применимо к:главному пользователю субъекта-службы
Чтобы получить GUID идентификатора клиента, выполните следующие действия.
Войдите в Microsoft Azure.
Найдите Регистрация приложений и выберите ссылку Регистрация приложений.
Выберите приложение Microsoft Entra, которое вы используете для внедрения содержимого Power BI.
В разделе "Обзор" скопируйте GUID идентификатора каталога (клиента).
Имя пользователя и пароль Power BI
Совет
Применимо к:главному пользователю субъекта-службы
Получите имя пользователя и пароль пользователя Power BI, который вы используете в качестве главного пользователя. Это тот же пользователь, который использовался для создания рабочей области и отправки отчета в служба Power BI.
Шаг 6. Доступ к API субъекта-службы
Совет
Применимо к:главному пользователю субъекта-службы
Этот шаг относится только к использованию метода проверки подлинности субъекта-службы . Если вы используете основного пользователя, пропустите этот шаг и перейдите к шагу 7. Включите доступ к рабочей области.
Чтобы приложение Microsoft Entra могло получить доступ к содержимому и API Power BI, администратор Power BI должен включить доступ к субъекту-службе на портале администрирования Power BI. Если вы не являетесь администратором клиента, получите администратора клиента, чтобы включить параметры клиента.
В служба Power BI выберите портал Параметры> Параметры> Администратор.
Выберите параметры клиента и прокрутите вниз до раздела "Параметры разработчика".
Разверните субъекты-службы, чтобы использовать API Fabric и включить этот параметр.
Примечание.
При использовании субъекта-службы рекомендуется ограничить доступ к параметрам клиента с помощью группы безопасности. Дополнительные сведения об этой функции см. в следующих разделах статьи субъекта-службы :
Шаг 7. Включение доступа к рабочей области
Чтобы включить объекты доступа к приложению Microsoft Entra, такие как отчеты, панели мониторинга и семантические модели в служба Power BI, добавьте субъекта-службы или основного пользователя в качестве члена или администратора в рабочую область.
Выполните вход в службу Power BI.
Прокрутите страницу до рабочей области, для которой требуется включить доступ, и в меню "Дополнительно " выберите "Доступ к рабочей области".
В области Access в зависимости от используемого метода проверки подлинности скопируйте субъект-службу или основного пользователя в текстовое поле "Ввод адреса электронной почты".
Примечание.
Если вы используете субъект-службу, его имя — это имя, которое вы предоставили приложению Microsoft Entra.
Выберите Добавить.
Шаг 8. Внедрение содержимого
Пример приложения Power BI embedded позволяет создавать внедрение приложения Power BI для клиентов .
Выполните следующие действия, чтобы изменить внедрение примера приложения для клиентов , чтобы внедрить отчет Power BI.
Откройте папку примеров разработчика Power BI.
Выберите "Код" и выберите "Скачать ZIP-файл".
Извлеките скачанный ZIP-файл и перейдите в папку PowerBI-Developer-Samples-master .
В зависимости от языка, который вы хотите использовать приложение, откройте одну из следующих папок:
- .NET Core
- .NET Framework
- Java
- Node.js
- Python
Примечание.
Внедрение примеров приложений для клиентов поддерживает только платформы, перечисленные выше. Пример приложения React поддерживает только внедрение решения организации .
Откройте папку Внедрения для клиентов .
Откройте пример приложения для клиентов, используя один из следующих методов:
Если вы используете Visual Studio, откройте файл AppOwnsData.sln .
Если вы используете Visual Studio Code, откройте папку AppOwnsData .
Откройте appsettings.json.
В зависимости от метода проверки подлинности заполните следующие значения параметров:
Параметр Субъект-служба Главный пользователь AuthenticationMode
ServicePrincipal MasterUser ClientId
Идентификатор клиента приложения Microsoft Entra Идентификатор клиента приложения Microsoft Entra TenantId
Идентификатор клиента Microsoft Entra Неприменимо PbiUsername
Неприменимо Имя пользователя master, см. в разделе "Имя пользователя и пароль Power BI" PbiPassword
Н/П Главный пароль пользователя см. в разделе "Имя пользователя и пароль Power BI" ClientSecret
Секрет клиента идентификатора Microsoft Entra Н/П WorkspaceId
Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области" Идентификатор рабочей области с внедренным отчетом см. в разделе "Идентификатор рабочей области" ReportId
Идентификатор внедренного отчета см. в разделе "Идентификатор отчета" Идентификатор внедренного отчета см. в разделе "Идентификатор отчета" Запустите проект, выбрав соответствующий параметр:
Если вы используете Visual Studio, выберите IIS Express (воспроизведение).
Если вы используете Visual Studio Code, выберите "Запустить > отладку".
Разработка приложения
После настройки и запуска внедрения для клиентов примера приложения можно начать разработку собственного приложения.
Попробуйте воспользоваться игровой площадкой встроенной аналитики Power BI, чтобы приступить к разработке и следить за всеми новыми функциями и обновлениями Power BI Embedded.
Когда вы будете готовы, просмотрите требования к рабочей среде . Вам также потребуется емкость и ознакомьтесь со статьей по планированию емкости, чтобы установить, какой номер SKU лучше подходит для ваших потребностей.
Внимание
Если вы использовали бесплатные маркеры пробной версии для разработки, необходимо приобрести емкость для рабочей среды. Пока емкость не будет приобретена, баннер бесплатной пробной версии будет по-прежнему отображаться в верхней части внедренного отчета.
Связанный контент
Есть еще вопросы? Спросите Сообщество Power BI.