Reporting Hub Knowledge Center
  • Reporting Hub Knowledge Center
  • GETTING STARTED
    • Required Azure Services
    • Deployment Step-by-Step
      • Self-Serve Guided Install
      • Enable Power BI Service Settings
      • Configure Reporting Hub App Settings
      • Set Your Home Page
    • Azure Portal Administration
  • CONCEPTS
    • Reporting Hub Architecture
    • AaaS end-to-end Architecture
    • Security & Trust Center
    • App Performance
  • TUTORIALS
    • App Settings
      • Tenant Admin
        • Tenant Switching
      • Managing Your Subscription
      • Authentication Admin
      • Language Admin
      • SMTP Setup
      • Payment Provider Integrations
      • Notifications Admin
    • Embedded Capacity Admin
      • Switching to a Fabric Capacity
    • Connect Power BI Workspaces
    • Customize Theme
      • Branding (Images and Text)
      • Theme and Layout
      • Colors
        • Colors Overview
      • Fonts
    • Managing Content
      • The Manage Navigation Menu
      • Adding a Category
      • Embedding Power BI Content
      • Row Level Security
      • Search Tags
      • Content Page Options
      • Embedding a URL Page
      • Create Embed URL Links
    • Report Options
      • Create Report Bookmarks
      • Schedule Email Reports
      • Favorites
    • Managing Your Gateway
    • User Management
      • Managing User Access
      • Managing Groups
      • Managing Users in Entra ID
    • Secondary Environment (Test/Prod)
    • Embed the Reporting Hub in Your App
    • Usage Analytics
      • App Usage Tracking with Google Analytics
      • App Usage Tracking with SQL DB
    • Azure Resource Monitoring
    • Self-Serve Guided Updates
    • Azure Marketplace Install
  • Reference
    • Troubleshooting
    • What's new in the Reporting Hub?
    • Support Runbooks
      • Critical System Outage (L1)
      • Users Unable to Access (L2)
      • Content Not Available (L2)
      • Application is slow/getting slower (L2)
      • Capacity not starting/stopping automatically
Powered by GitBook
On this page
  • Enable Power BI Tenant Admin Settings
  • 1. Integration Settings
  • 2. Developer Settings
  • 3. Admin API Settings
  • Power BI Workspace Configuration
  • 1. Assign your workspace to your Embedded or Fabric Capacity
  • 2. Add the Reporting Hub Application to your Workspace
  • 3. Add the Workspace to your Reporting Hub Global Tenant
  1. GETTING STARTED
  2. Deployment Step-by-Step

Enable Power BI Service Settings

Give the Reporting Hub permission to access Power BI

PreviousSelf-Serve Guided InstallNextConfigure Reporting Hub App Settings

Last updated 5 days ago

For the Reporting Hub (an Azure AD app) to access Power BI content and APIs, a Power BI admin needs to enable the following settings:

Enable Power BI Tenant Admin Settings

1. Integration Settings

1.A. Enable XMLA endpoint

Go to Tenant settings in the Power BI Admin portal, and scroll down to Integration settings.

Enable the Allow XMLA endpoints and Analyze in Excel with on-premises datasets switch either for the entire organization or for the specific security group you created in Azure Entra ID.

https://learn.microsoft.com/en-us/power-bi/enterprise/service-premium-connect-tools#security

Note: If you choose 'specific security group', you must add the Reporting Hub Service Principal security group you created as part of the installation process.

2. Developer Settings

2.A. Embed Content in Apps

Enable the Embed content in apps switch either for the entire organization or for a specific security group you created in Azure Entra ID.

Note: If you choose 'specific security group' you must add the Reporting Hub Service Principal user you created as part of the installation process.

2.B. Allow Service principals to use Fabric APIs

Enable the Service principals can use Fabric APIs switch either for the entire organization or for the specific security group you created in Azure Entra ID.

Note: If you choose 'specific security group', you must add the Reporting Hub Service Principal security group you created as part of the installation process.

2.C. Allow service principals to create and use profiles

Enable the Allow service principals to create and use profiles switch either for the entire organization or for the specific security group you created in Azure Entra ID.

Note: If you choose 'specific security group', you must add the Reporting Hub Service Principal security group you created as part of the installation process.

3. Admin API Settings

3.A. Enable Enhance admin APIs responses with detailed metadata

Enable the Enhance admin APIs responses with detailed metadata switch either for the entire organization or for the specific security group you created in Azure Entra ID. To learn more about the Admin API Settings, visit the Microsoft link below the screenshot.

Note: If you choose 'specific security group', you must add the Reporting Hub Service Principal security group you created as part of the installation process.

Power BI Workspace Configuration

There are three steps you need to perform in order to make your Power BI workspaces available in the Reporting Hub.

Please Note: your personal 'My Workspace' can not be added to the Reporting Hub.

1. Assign your workspace to your Embedded or Fabric Capacity

To add a Power BI workspace to an embedded capacity, you'll need to:

  1. Log in to: https://app.powerbi.com

  2. On the left menu, choose the Workspace you want to add to the Fabric or Embedded capacity, click on the three-dot menu and choose Workspace Settings.

  3. On the Premium tab, switch the license mode to Embedded or Fabric. If you have more than one embedded capacity, select the one that is being managed by Reporting Hub and click Apply.

If capacity is greyed out: The capacity selection will only be visible to you if you are a Capacity administrator and the capacity is currently active. If the capacity is paused, you can start it by either going to the Azure portal and starting the capacity or by signing into Reporting Hub and the application will start the capacity automatically.

2. Add the Reporting Hub Application to your Workspace

In your Reporting Hub application, navigate to App Settings > App Information. Copy the Name of your service principal and note the Client ID.

Navigate to Power BI Service. Select the Workspace you want to add to the Reporting Hub, click on the three-dot menu, and choose Manage Access > + Add people or groups.

Note: A diamond icon next to a Workspace means that it is running on a premium capacity.

In the 'Enter name or email' field, paste the Name that you copied from your application and select the one that shows an AppID under the name. If you see multiple apps with the same name, select the one with the AppID that matches the Client ID in your app.

You must set the permission to either Member or Admin. Click Add.

By using the application, workspaces are typically available in the Reporting Hub within minutes. If you choose the security group instead of the application, workspaces will take longer (hours or even next day) to become available in the Reporting Hub application.

Service principal not showing up? Ensure you have enabled your Power BI Tenant settings and that your Service principals can use Fabric APIs setting is either enabled for the entire organization or that the service principal you want to add is a member of one of the specified groups.

3. Add the Workspace to your Reporting Hub Global Tenant

Now that your workspace is added to your capacity and you have granted your Reporting Hub application permission, you will need to add the workspaces to your Reporting Hub Global Tenant. We will go through this in the next step in Configure Reporting Hub App Settings.

Important: Your workspace must contain content for it to be added to the Reporting Hub. An empty workspace will not be visible to the Reporting Hub. If your workspace is empty, please add content to it now.

LogoAdmin API admin settings - Microsoft FabricMicrosoftLearn