Registering an Azure app to use with Power BI

Learn to register an Azure Active Directory application that uses Power BI before you connect to Analytics Content Hub

About this task

Cloud-based hosted solutions that use REST interfaces, for example, Google and Box, have the same prerequisite to register an Azure Active Directory application that uses Power BI. A Microsoft Azure administrator must create the application to connect to Analytics Content Hub.

Procedure

  1. Sign in to Azure as an administrator through the portal.
  2. From the menu, click Azure Active Directory > App registrations > New registration.
    1. On the Register an application screen, provide a Name for the application.
    2. Select the required Supported account types option. Typically, Accounts in this organizational directory only is selected, but this value varies based on the needs of your installation.
    3. Required: The Redirect URI (optional) is required to allow Power BI to return to Analytics Content Hub during the authentication process. The value for this parameter must be https://analyticscontenthub_servername:9443/Theia/oauth/authFinish(example). Set the drop-down value to Web.
    4. Click Register.
  3. From the menu, click API permissions > Add a permission.
    1. Click Power BI Service.
    2. For What type of permissions does your application require, select Delegated permissions.
    3. Click the following permissions from each drop-down list item:
      • Microsoft Graph (1)
        • User.Read
      • Power BI Service (11)
        • App.Read.All
        • Capacity.Read.All
        • Dashboard.Read.All
        • Dataflow.Read.All
        • Dataset.Read.All
        • Gateway.Read.All
        • Report.Read.All
        • StorageAccount.Read.All
        • Tenant.Read.All
        • UserState.ReadWrite.All
        • Workspace.Read.All
      Important: If the Power BI Persistent Filters feature is required for use in Analytics Content Hub, the UserState.ReadWrite.All API permission is required.
    4. Click Add permissions.
  4. Optional: At the end of the API permissions screen, click Grant admin consent for domain.com to bypass the content screen for users. Then click Yes.
  5. Click Certificates & secrets > New client secret.
    1. Type a Description and select Never for the expiry.
    2. Click Add.
  6. Take note of the Value as it is used in Analytics Content Hub (as appSecret) to connect to Power BI.

Important: Copy this Value because it will not be visible again. If this appSecret is lost, then create a new appSecret by repeating step 5.

  1. From the App registrations screen, take note of the Application (client) ID value for the newly created application.

What to do next

To create the Analytics Content Hub connector, see Connect to Microsoft PowerBI.