To simplify the configuration of Power Embedded, we have prepared a script that automates the process of importing users, RLS, and Power BI reports into Power Embedded in a simple and easy way.
Requirements
To successfully execute the migration process, the following permissions must be enabled:
Admin permission for the service user
This permission must be enabled in all workspaces that will be available in the portal.
To add the created Service Principal as a workspace administrator, access the workspace, click on the three dots, and select the "Manage access" option.
Click the “+ Add people or groups” button.
PSearch for the name of the previously created application (PowerEmbedded-App) and remember to change the access level to Administrator. Then, click the Add button.
That's it! Power Embedded now has access to this workspace. Repeat this process for all workspaces from which you want to import reports.
API Read Permissions
Permissions for Importing Data from Entra ID
To import user and group data from Entra ID, specific permissions must be assigned to the Service Principal created in the Azure Portal, which is used by Power Embedded to communicate with your environment.
In the App Registrations screen, search for the name of the created application (the default name is PowerEmbedded-App).
In the application screen, click on API Permissions in the side menu and then on Add a Permission
On the next screen, select the Microsoft Graph option.
Then, choose Application permissions.
In the following tab, search for Directory and select the first option, Directory.Read.All, then click Add permissions.
To finalize, grant admin consent by clicking on Grant admin consent for.
That's it! Now you will be able to import users and groups from Azure AD (Entra ID) into Power Embedded.
Instructions
With the necessary permissions enabled, simply follow the step-by-step process below.
Go to the Power Embedded administration portal, navigate to the migration menu, and follow these steps:
Step 1: Generate the access tokens using the button below and copy them. The generated token will be valid for only 1 hour.
Step 2: Open the PowerShell script available in the link on this page, copy it, and paste it into the PowerShell console.
Step 3: Replace the script variables with their respective values:
Power BI Client ID: Access the Power BI Embedded Administration Portal > Settings > “Power BI Client ID” field.
API Key: Access the Power BI Embedded Administration Portal > Settings > “API Key” field (click the red icon to generate the key).
PBI Token: Key generated in the migration menu.
AD Token: Key generated in the migration menu.
With all the fields filled in, simply run the script in PowerShell.
Once the script is completed, all reports, users, and RLS will be successfully imported into Power Embedded.
