Introduction

In this step of the Integrate a tile into an app walkthrough, you register your app in Azure Active Directory (AD). You need to do this first so that you have a Client ID and Client Secret that identifies your web app in Azure AD. Without a Client ID and Client Secret, Azure AD cannot authenticate your web app. If you downloaded the Integrate a tile sample, you use the Client ID and Client Secret you get after registration to configure the sample so that the sample can authenticate to Azure AD.

NOTE: Before you register a web app for Power BI, you need to Sign up for Power BI.

Here are the steps to register a web app in Azure AD.

Register a web app in Azure AD

  1. Go to dev.powerbi.com/apps.
  2. Click Sign in with your existing account, and sign into your Power BI account.
  3. Enter an App Name. For this walkthrough, enter Integrate a tile sample.
  4. For App Type, choose Server-side Web app.
  5. Enter a Redirect URL. For this walkthrough, Azure AD redirects back to the default page, so enter http://localhost:13526. Azure Active Directory (AD) will redirect to this page with an Authorization Code. To learn how to acquire an Access Token to access Power BI tiles using an Authorization Code, see Get an authentication access token.
  6. Enter a Home Page. For this walkthrough, enter http://localhost:13526 which is the home page for the sample.
  7. For Choose APIs to access, choose Read All Dashboards (preview). For all Power BI app permissions, see App permissions.
  8. Click Register app, and save the Client ID and Client Secret that was generated. A Client ID and Client Secret identifies the app in Azure AD. To configure the Integrate a tile sample to use the Client ID and Client Secret to authenticate, see Configure the integrate a tile sample.

Here's how your Register an Application for Power BI page should look:

Now that you have registered your web app with Azure AD, you can get an authorization access token from Azure AD to access Power BI dashboards and tiles.

After you have a Client ID and Client Secret, you can configure your web app, such as the Integrate a tile sample, to be able to access Power BI tiles. The next section shows you how to configure the sample.

Configure the Integrate a tile sample

If you downloaded the Integrate a tile sample, you use the Client ID and Client Secret you get after registration so that the sample can authenticate to Azure AD. To configure the sample, change the Client ID and Client Secret in web.config. To learn more about how to authenticate to Azure AD, see Step 2: Get a Power BI dashboard.

Next step

To integrate a tile into an app, you need to get a tile which is in a dashboard. In the next step, you learn how to Get a Power BI dashboard. In step 3, you learn how to get a tile from a dashboard.

Next Step >

See also

Sign up for Power BI
Integrate a tile into an app walkthrough
Integrate a tile sample
Configure the integrate a tile sample
Get an authentication access token
App permissions
Step 2: Get a Power BI dashboard
More questions? Try the Power BI Community