Set up and configure the Power BI tenant settings
Follow the steps below to create a security group for the Power BI tenant Settings, add a Power BI app registration to the security group, and update the tenant settings.
Last updated
Follow the steps below to create a security group for the Power BI tenant Settings, add a Power BI app registration to the security group, and update the tenant settings.
Last updated
Note: You can skip this step if you already have a security group.
Type "Microsoft Entra ID" in the Azure portal search bar and select said option as it appears.
Select Groups (under Manage) from the left pane.
Click on New group to create a new security group.
Fill out the New Group form as detailed below:
Group type: "Security"
Group name: Create a name for the group. In our example, we named the group PowerBIPLA, hence it will be referred to as such in this documentation's images, etc. Feel free to create your own group name.
Group description: Optional.
Membership type: Pre-selected, it should be "Assigned".
Click Create to create the security group.
Select All groups from the left pane of the Microsoft Entra ID page.
Type your security group's name in the search bar and click on it.
Note: As mentioned in the previous section, we named our group PowerBIAPISG, hence it will be referred to as such in this documentation.
Select Members (under Manage) from the left pane and click on Add members.
Search for the name of the app registration created for the LoadFAST API and select it. Click on the Select button to add the app registration to the security group.
Granting the app registration (also known as the service principal) member-level access to a Power BI workspace is required to calculate the PLT for that workspace's reports.
Note: Repeat the following steps for each workspace where the LoadFAST will be used to calculate the PLT of that workspace's reports.
Go to the Power BI web application/Power BI Service.
Go to the workspace that you want to grant the tool access to.
Click on Manage access once on the workspace.
Select Add people or groups.
Enter the name of the service principal (name of the app registration) which was created previously.
Select the Member role as Member.
Click Add to assign the role.
Repeat the above steps for all the workspace that you want to add or provide access to the service principal to calculate the Page Load Time for that workspace reports.
Go to the Power BI web application/Power BI Service.
Click on the settings icon on the top right-hand corner and sign into the Admin portal using your Power BI administrator credentials (only an administrator account can access these settings).
Note: The Power BI service must be in the same tenant where you will deploy the LoadFAST tool.
Once you're on the Tenant settings page, modify the settings detailed below:
Note: Ensure that the LoadFAST API app registration was added to the security group as detailed in this step. This is needed to make sure the required access can be granted and the tool can work properly.
Scroll down within the Tenant settings page to find the Admin API settings. Configuring Admin API settings will give access or rights to administrators. Configure the setting as detailed below:
Expand the Allow service principals to use read-only admin APIs setting. Enable the setting using the toggle.
Note: Under the Apply to section of this setting, add the previously created/your selected security group into the Specific security groups section. Click Apply to save the changes. Repeat this step for each setting detailed below.
Expand the Enhance admin APIs responses with detailed metadata setting. Enable the setting using the toggle.
Developer settings
Scroll down within the Tenant settings page to find the Developer settings. These settings are required for the app registration created to use Power BI related APIs. Configure the setting as detailed below:
Expand the Allow Service Principal to use Power BI APIs setting. Enable the setting using the toggle.
Under the Apply to section, add the previously created/your selected security group into the Specific security groups section. Click Apply to save the changes.
Note: Skip this step you are using a Premium workspace.
Go to the Power BI web application/Power BI Service.
Select Workspaces from the left-hand menu.
Find the workspace you're using for embedding your content. Click on ... next to the workspace's name and select Workspace settings.
Select the Premium tab and do the following:
Under License mode, select the type of capacity you created previously: Premium capacity or Embedded.
Select the capacity previously created and select Apply to save the changes.
After you assign your workspace to a capacity, a diamond appears next to it in the Workspaces list.
