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 Marketplace Install
  • CONCEPTS
    • Reporting Hub Architecture
    • AaaS end-to-end Architecture
    • Security & Trust Center
  • TUTORIALS
    • Azure Portal Administration
    • 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
    • App Performance
    • Azure Resource Monitoring
    • Self-Serve Guided Updates
  • Reference
    • What's new in the Reporting Hub?
    • Troubleshooting
    • 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
  • How it works with Power BI
  • Component Functions
  • Microsoft Entra ID (B2B)
  • Power BI Embedded
  • Azure App Service
  • Azure SQL Database
  • Reporting Hub License Manager
  1. CONCEPTS

Reporting Hub Architecture

PreviousAzure Marketplace InstallNextAaaS end-to-end Architecture

Last updated 2 months ago

The Reporting Hub is an Azure-based application that is installed and deployed within your Azure environment. It integrates with your existing Microsoft tenant and communicates with Power BI Embedded via Microsoft APIs. The following Azure services are required to run the Reporting Hub:

  1. Power BI Embedded or Fabric Capacity

  2. Azure App Service

  3. Azure SQL Database

Below is a diagram highlighting the high level architecture.

How it works with Power BI

The Reporting Hub communicates with Power BI Embedded via Microsoft APIs. The below list includes the key communication areas:

  • Connects to authorized Power BI Workspaces, Reports and Dashboards

  • Applies Row-level-security (RLS) based on authenticated user

  • Built-in capacity optimizer manages Power BI Embedded Capacity availability based on usage

  • Connections to data sources are established through Power BI

  • Works with all Power BI Embedded, Fabric and Power BI Premium Microsoft licenses

Important: Your data is NEVER accessed by, made available to, or, stored within the Reporting Hub web application.

Component Functions

Microsoft Entra ID (B2B)

Microsoft Entra ID (formerly called Azure Active Directory or AAD) is the default authentication method for the Reporting Hub. Entra ID B2B allows you to add guest users (outside of your tenant). Users and Groups are managed in Entra ID and are used to provide access to navigation options, reports and row-level security.

Note: The Reporting Hub also supports Okta, OpenID Connect & Auth0 authentication schemes. See Authentication Adminfor more information.

Power BI Embedded

Power BI Embedded is the Microsoft license required to share Power BI content with un-licensed users. Your embedded capacity is applied to the Power BI workspaces you wish to make available to the Reporting Hub.

Azure App Service

The Reporting Hub is a stand-alone application instance installed directly within your Azure environment. An Azure App Service is required to 'host' the application.

Azure SQL Database

All the Reporting Hub application configuration data (logos, themes, navigation, report security, and audit logs) are stored in this Azure SQL Database.

Reporting Hub License Manager

The Reporting Hub license manager is a separate application that runs within the Reporting Hub Azure environment. Your locally deployed Reporting Hub application instance periodically communicates with the license manager to validate subscription.

Important: Communication between your application and the Reporting Hub license manager is a simple ping via strongly encrypted keys. No data of any kind is stored with the license manager. The Reporting Hub license manager can request and read the locally deployed Reporting Hub instance application log files by default. Read access to the application log files can be disabled and blocked by the customer if desired.

Log files made available to Reporting Hub license manager

The Reporting Hub application log has 2 types of entries:

Information:

  • Entries to show if the app can access the database --> checkdatabase information Returned: found org

  • Entries to show CapacityManager function

  • Entries to show number of active tenants

  • CapacityManagement function when started

when CapacityManagement/CapacityResume

when CapacityManagement/Pause

when CapacityManagment/Refresh Schedule

  • Entries for Cache Management

When it skipped and when it cleared Memory

  • Entries for Checking Ad App Secret

when was the app secrete checked /updated

Exceptions:

  • It records all the Exceptions and the functions involved along with debug information the application gets from Microsoft or the Reporting Hub App itself

Related Article

For more information on the Azure services required please reference:

Required Azure Services