diff --git a/openmetadata-docs/content/menu.md b/openmetadata-docs/content/menu.md index 4c8a5215764..de136e74c7a 100644 --- a/openmetadata-docs/content/menu.md +++ b/openmetadata-docs/content/menu.md @@ -296,6 +296,8 @@ site_menu: url: /openmetadata/connectors/dashboard/tableau/cli - category: OpenMetadata / Connectors / Dashboard / PowerBI url: /openmetadata/connectors/dashboard/powerbi + - category: OpenMetadata / Connectors / Dashboard / PowerBI / PowerBI Account Setup + url: /openmetadata/connectors/dashboard/powerbi/powerbi-account-setup - category: OpenMetadata / Connectors / Dashboard / PowerBI / Airflow url: /openmetadata/connectors/dashboard/powerbi/airflow - category: OpenMetadata / Connectors / Dashboard / PowerBI / CLI diff --git a/openmetadata-docs/content/openmetadata/connectors/dashboard/powerbi/setup-powerbi-account.md b/openmetadata-docs/content/openmetadata/connectors/dashboard/powerbi/setup-powerbi-account.md new file mode 100644 index 00000000000..4089cca61aa --- /dev/null +++ b/openmetadata-docs/content/openmetadata/connectors/dashboard/powerbi/setup-powerbi-account.md @@ -0,0 +1,34 @@ +--- +title: PowerBI Account Setup +slug: /openmetadata/connectors/dashboard/powerbi/powerbi-account-setup +--- + +# PowerBI Account Setup + +### Requirements + - PowerBi Pro license is required to access the APIs + +### Step 1: Create an Azure AD app and configure the PowerBI Admin consle + +Please follow the steps mentioned [here](https://docs.microsoft.com/en-us/power-bi/developer/embedded/embed-service-principal) for setting up the Azure AD application service principle and configure PowerBI admin settings + +Login to Power BI as Admin and from `Tenant` settings allow below permissions. +- Allow service principles to use Power BI APIs +- Allow service principals to use read-only Power BI admin APIs +- Enhance admin APIs responses with detailed metadata + +### Step 2: Provide necessary API permissions to the app +Go to the `Azure Ad app registrations` page, select your app and add the dashboard permissions to the app for PowerBI service and grant admin consent for the same: +- Dashboard.Read.All +- Dashboard.ReadWrite.All + + + +Make sure that in the API permissions section **Tenant** related permissions are not being given to the app +Please refer [here](https://stackoverflow.com/questions/71001110/power-bi-rest-api-requests-not-authorizing-as-expected) for detailed explanation + + + +### Step 3: Create New PowerBI workspace +The service principal only works with [new workspaces](https://docs.microsoft.com/en-us/power-bi/collaborate-share/service-create-the-new-workspaces). +[For reference](https://community.powerbi.com/t5/Service/Error-while-executing-Get-dataset-call-quot-API-is-not/m-p/912360#M85711) \ No newline at end of file