Using the Power BI Widget within GoBright View

It is good practice to create a new user within Power BI, a service account if you will, specifically for this use case. This user will be used within GoBright View.

1. Open the Power BI App Registration Tool (https://app.powerbi.com/embedsetup)
2. In the Choose an embedding solution section, select Embed for your organization
3. In Step 1 – sign in to Power BI, sign in with a user that belongs to your Power BI tenant. The Azure AD app will be registered under this user.
4. In Step 2 – Register your application, fill in the following fields:
   • Application Name– Give your application a name.
   • Home Page URL– Enter a URL for your home page.
   • Redirect URL– Upon signing in, your application users will be redirected to this address while your application receives an authentication code from Azure. Select one of these options:
     • Use a default URL (preferred) – This option will automatically create and download a sample embedded analytics application. The default URL is http://localhost:13526/.
     • Use a custom URL – Select this option if you already have an embedded analytics application, and know what you want to use as a redirect URL.
   • API access– Select these permissions:
     • Read all dashboards
     • Read all reports
       

5. Select Register
   
   
   6. Your Azure AD app Application ID and Application Secret Value are displayed in the Summary box. Copy these values for Step 6.
      
      
6. If you haven’t made a Power BI workspace yet, you can do it here. You can always do this later from the Power BI application.
7. This windows or tab can now be closed.

For more information refer to the Microsoft docs.

After registering your Azure App, you need to setup the required API Permissions. You can easily do this by following these steps:

1. Log into Microsoft Azure.
2. Search for App registrations and select the App registrations
3. Select the Azure AD app you’re using for embedding your Power BI content.
   • If the App does not show up, click on All applications, your application will show up there.
4. Under Manage, select API permissions.
5. Under Configured Permissions, select Add a permission.
6. In the Request API permissions pop-up window, select the Power BI Service API.
7. Select Delegated permissions and select the following permissions:
   Note: for Tenant.Read.All and Tenant.ReadWrite.All admin consent is required.

8. When the permissions are set this tab can be closed.

Create a workspace within Power BI.

Publish a Power BI Report. Make sure it’s within the workspace mentioned in the previous step.

The following information is needed within GoBright View (the next and final step).

Username:

The username of the account (email address). Preferably the account created in step 1.

Password:

The password of the account.

URL

The entire url of the report you want to show.
To find this: open the report in Power BI and then copy the entire URL. The url should look something like this: https://app.powerbi.com/groups/[group-id]/reports/[report-id]/ReportSection

Azure Client ID

1. This is the Application ID you copied in Step 1.
2. If you lost the ID or forgot to copy it, follow the following steps:
   1. Log into Microsoft Azure.
   2. Search for App registrations and select the App registrations
   3. Select the Azure AD app your using for embedding your Power BI content.
   4. From the Overview section, copy the Application (client) ID

Client Secret

1. This is the Application Secret you copied in Step 1.
2. If you lost the Secret or forgot to copy it, follow the following steps:
   1. Log into Microsoft Azure.
   2. In the search bar on top, type App registrations and select the App registrations
   3. Select the Azure AD app created earlier in Step 1
   4. Under Manage, select Certificates & secrets.
      
   5. Under Client secrets, select New client secret.
      
   6. In the Add a client secret pop-up window, provide a description for your application secret, select when the application secret expires, and select Add.
      Note this date in your calendar so you can renew this on time.
   7. From the Client secrets section, copy the string in the Client Secret Value column of the newly created application secret.
      

      The Client Secret Value always contains ~ (tildes).

1. Create a new template or slide and add the Power BI widget
2. Open the widget parameters and enter all the information gathered
   Microsoft username: the email address of the account mentioned in Step 1
   Microsoft password: the password of the account mentioned in Step 1
   Azure Client ID: the Client ID of the created Azure App in Step 6
   Client Secret Value: the Secret Value of the created Azure App in Step 6, the one with the ~ (tildes)
   InputUrl: the entire URL from Step 6.
3. Save the template and add it to a playlist.

Enjoy your embedded content!