Events
Power BI DataViz World Championships
Feb 14, 4 PM - Mar 31, 4 PM
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreThis browser is no longer supported.
Upgrade to Microsoft Edge to take advantage of the latest features, security updates, and technical support.
Learn how to embed analytical content within your business process applications for the national/regional cloud. Use the Power BI .NET SDK with the Power BI JavaScript API to embed a report, dashboard, or tile, into your web applications.
Power BI supports the following national/regional clouds:
U.S. Government Community Cloud (GCC)
U.S. Government Community Cloud High (GCC High)
U.S. Military Contractors (DoDCON)
U.S. Military (DoD)
Power BI for China cloud
To get started with this walkthrough, you need a Power BI account. If you don't have an account set up, depending on the type of government or country/region, you can choose the right national/regional cloud for you. Sign up for a U. S. government Power BI account, or a Power BI for China cloud account.
Note
Are you looking to embed a dashboard for your organization instead? See Integrate a dashboard into an app for your organization.
To integrate a dashboard into a web app, use the Power BI API and a Microsoft Entra authorization access token to get a dashboard. Load the dashboard using an embed token. The Power BI API provides programmatic access to specific Power BI resources. For more information, see Power BI REST API, Power BI .NET SDK, and the Power BI JavaScript API.
This article shows the code for the App Owns Data sample on GitHub. To follow along with this walkthrough, download the sample. We're using the .NET Framework/Embed for your customers
directory.
Important
You can only embed Power BI content from a Government Community Cloud (GCC) with a Microsoft 365 SKU. Other national/regional cloud customers can use Microsoft 365 or Azure SKUs.
Government Community Cloud (GCC):
In the Web.config file, update applicationId
(Native app applicationId
), workspaceId
, the username (your master user), and password.
Next, add the GCC parameters as follows.
<add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
<add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />
Military Contractors (DoDCON):
In the Web.config file, update applicationId
(Native app applicationId
), workspaceId
, the username (your master user), and password.
Next, add the DoDCON parameters as follows.
<add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />
Military (DoD):
In the Web.config file, update applicationId
(Native app applicationId
), workspaceId
, the username (your master user), and password.
Next, add the DoDCON parameters as follows.
<add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />
Power BI for China cloud parameters
In the Web.config file, update applicationId
(Native app applicationId
), workspaceId
, the username (your master user), and password.
Next, add the Power BI for China cloud parameters as follows.
<add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
<add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />
Register your application with Microsoft Entra ID to make REST API calls. For more information, see Register a Microsoft Entra app to embed Power BI content. Since there are different national/regional cloud affiliations, there are distinct URLs to register your application.
Government Community Cloud (GCC) - https://app.powerbigov.us/apps
Military Contractors (DoDCON) - https://app.high.powerbigov.us/apps
Military (DoD) - https://app.mil.powerbigov.us/apps
Power BI for China cloud - https://app.powerbi.cn/apps
If you downloaded the Embedding for your customer sample, you would use the applicationId
you get, so that the sample can authenticate to Microsoft Entra ID. To configure the sample, change the applicationId
in the web.config file.
Within your application, you need to get an access token, from Microsoft Entra ID, before you can make calls to the Power BI REST API. For more information, see Authenticate users and get a Microsoft Entra access token for your Power BI app. Since there are different national/regional cloud affiliations, there are distinct URLs to get an access token for your application.
Government Community Cloud (GCC) - https://login.microsoftonline.com
Military Contractors (DoDCON) - https://login.microsoftonline.us
Military (DoD) - https://login.microsoftonline.us
Power BI for China cloud - https://login.chinacloudapi.cn
You can see examples of these access tokens within each content item task in the Controllers\HomeController.cs file.
Now that you have an access token, you can continue embedding as you would on any other platform.
More questions? Ask the Power BI Community
Events
Power BI DataViz World Championships
Feb 14, 4 PM - Mar 31, 4 PM
With 4 chances to enter, you could win a conference package and make it to the LIVE Grand Finale in Las Vegas
Learn moreTraining
Learning path
Use advance techniques in canvas apps to perform custom updates and optimization - Training
Use advance techniques in canvas apps to perform custom updates and optimization
Certification
Microsoft Certified: Power Platform Developer Associate - Certifications
Demonstrate how to simplify, automate, and transform business tasks and processes using Microsoft Power Platform Developer.