Register the workspace on DNN

Once the module has been installed, you can start registering Power BI workspaces. To register a workspace in DNN, you specify the credentials to connect to the Power BI API, the Application ID identifying the DNN portal with granted access to the Power BI API required scopes and the workspace ID. Note that these two values are the result of following the Set up your Power BI embedding environment process.

Register a workspace

Workspaces are registered by portal. This allows you to isolate the workspace configuration and permissions by portal if a DNN installation contains more than one, contemplating the multi-portal scenario.

To register a workspace, login as admin of the portal and open the Settings > Power BI Embedded settings through the persona bar.

1. On general settings, click on the + Register Workspace link.
2. On the Workspace Name, type a name for the workspace that you would like to show to your users. This can be different from the workspace name used at PowerBI.com
3. Select the Authentication Type from Master User or Service Principal. If you are setting up your first workspace on a development environment, you would probably use Master User, so you can embed reports even with no Power BI embedded capacity provisioned. See Master accounts and service principals for more information.
4. If you selected Master User, type the username and password. If you selected Service Principal, enter the Service Principal ID and Secret.
5. Type the PowerBI Application ID (guid). This is the application ID of the registered application on your Azure AD tenant, with granted access to Power BI API scopes. If you followed the Set up your Power BI embedding environment process, is the resulting application ID.
6. Type the Workspace ID (guid) to register. This is the result of the process mentioned on the previous step. You can also get the workspace ID browsing your workspace at PowerBI.com and getting it from the URL (i.e. https://app.powerbi.com/groups/d9175a6a-fc79-42bd-ae01-227858101d92)
7. Type the Default Content Page URL where the contents will be shown on this site. This is the default content page URL being used by all Power BI embeeded listview controls on this portal.
8. Click on the Save button to finish the workspace registration process.

You can repeat the operation to register as many workspaces as you want.

IMPORTANT: registering a workspace just register an existing workspace, never creates a new one.

Workspace management operations

Once saved, by clicking on the icons to the right, you can do the following operations:

1. Browse the workspace. This option redirects you to the PowerBI.com to browse the workspace content through that portal.
2. Edit the workspace registration. Allows you to modify the current settings
3. Delete the workspace registration. This operation just deletes the registration on the DNN portal, never deletes a workspace on PowerBI.com

Next Steps

Once you have registered a workspace, Add access permissions to a workspace and elements.