Azure App Registration ​

This document outlines a step-by-step guide on how to create an Azure App Registration in your company's Azure Active Directory.

Intro ​

In order for Displagent to access your Power BI content, it requires you to setup an Azure App Registration in your company’s Azure Active Directory.

Microsoft Tool ​

Please navigate to the Microsoft-hosted Power BI Azure App Registration assistant tool. This tool allows you to choose a series of steps to easily create an Azure App Registration for Displagent.

At first glance, it might look a little overwhelming: don't worry! I have each step detailed below on how to navigate this.

1. Please click the Embed for your organization button.

2. After clicking the button, you may be prompted to sign into Power BI; please do so.

3. In the Application Name textbox, please type Displagent. In the Home Page URL textbox, please type https://localhost/. Don't worry about the Redirect URL textbox.

4. Please check the required permissions as indicated in the screenshot below. Then click the Register button.

Fetch IDs ​

Now that you've created the Azure App Registration, you need to actually fetch its IDs. You can find this information in your Azure Active Directory: once on the page, look for the new Azure App Registration that you made called Displagent.

You can also navigate to this page by logging into the Azure Portal and typing azure active directory in the searchbar at the top and navigating to the App registrations page.

Secret Value ​

Once on the App registrations page, click the Displagent app. Then navigate to the app's Certificates & secrets page. Click the Client secrets tab in the middle of the page, then click the New client secret button.

A new dialogue box should appear on the page with a Description textbox and an Expires dropdown.

In the Description textbox, add a short description such as For Displagent. In the Expires dropdown, choose a desirable expiry date.

Then click the Add button.

You should now see a new row appear for your newly-created secret.

GUIDs ​

Now, look to the left-hand side navbar and click the Overview tab of the Azure App Registration.

On this tab, you will see several GUIDs near the top of the page: you need the Application (client) ID and the Directory (tenant) ID GUIDs.

Grant Admin Consent ​

One last thing: on the left-hand side navbar, navigate to the API permissions page.

In the middle of the page, you should see a checkmark button called Grant admin consent for <your domain here>. Click that checkmark button.

You will know that admin consent has been successfully granted when you see green check marks on the right-side Status column.

Save IDs ​

Congratulations! You should now have all of the necessary permissions requirements and security provisions necessary for Displagent to embed your content.

To finalize this process, open Displagent, navigate to the Microsoft Integration page, choose the Advanced method, and enter each credential in its respective textbox. I have provided a Login To Microsoft button on this page to test your credentials and ensure you can connect to your Power BI tenant.