OData TUTORIAL
Connect to OData from Power BI using OAuth2 Authentication
Updated: 26 Feb 2021
Introduction
In this article, we will walk you through how you can connect to your data in Relational, Big Data or SaaS data sources via OData generated using Progress Hybrid Data Pipeline from Power BI. As Hybrid Data Pipeline supports OAuth2 for OData, we will be showing you how you can use OAuth 2 with OData in Power BI.
Pre-requisites
- Power BI
- Visual Studio 2017
- Power Query SDK installed in your Visual Studio
Download and Install Hybrid Data Pipeline Server
Creating OData 4 endpoint
- Open your browser and go to go to http://<server_ip_address> and you should see a login page as shown below. You should be able to access the UI without any port in the URL after you have redirected traffic on 80 to 8080 or 443 to 8443 for https.
- Login with the credentials that you have supplied during installation and you should be seeing the dashboard. Click on Data Sources tab on the side bar and you should see all the data stores that are supported.
- Click on SQL Server or your own database and you should now see a connection configuration page as shown below. Fill it up with your connection information for your database and click on Test Connect button to verify the connection.
Note: If you are connecting to a database On-Premise, you should find the On-Premise Connector ID, which you have configured above, in Connector ID drop down.
- Now go to OData tab and Click on Configure Schema button. You should now see all the schemas in your database, select your schema and now you should see all the tables in the schema as shown below. Select the tables that you want to access through.
- Click on Save & Close. Now go to OData tab and you should find the endpoint URL as shown below. If you don’t have the SSL enabled, fallback to http. The URL might be of following format: http://<server>/api/odata4/sqlserver
Register New Application for Power BI
- You need to Register Salesforce Connect as an application in Hybrid Data Pipeline for OAuth 2.0 Authorization.
- To do that, Open Postman and send a POST REQUEST as shown below
POST https:
//<server>/api/mgmt/oauth/client/applications
Body
{
"name"
:
"PowerBIAuth"
,
"description"
:
"Connect to Power BI via OAuth2"
,
}
Authentication Basic
- The Response from the Server will contain your Client Key and Client Secret and should be like something below.
{
"id"
: 1,
"name"
:
"PowerBIAuth"
,
"description"
:
"Connect to Power BI via OAuth2"
,
"clientId"
:
"xxxxx"
,
"clientSecret"
:
"xxxxxx"
}
- Keep a note of these Client ID and Client Secret, as you will use it later.
Enable Power BI Custom Data Connectors
- Enable the Custom data connectors preview feature in Power BI Desktop (under File | Options and settings | Custom data connectors)
Build the Power BI Extension
- Open Visual Studio and Create New -> Project. In the left pane, choose Power Query under templates. Choose Data Connector Project and create New Project with name ‘HdpOAuthConnect’
- In the Solution, find HDPOAuthConnect.pq file and copy the code from this Github Project
- In the above code, replace the values for
- Your Hybrid Data Pipeline OData Service URL
- Your Hybrid Data Pipeline Client ID
- Your Hybrid Data Pipeline Client Secret
- Your Hybrid Data Pipeline Authorize URL
- Your Hybrid Data Pipeline Token URL
- Save the file and Build the Solution. Now go to bin folder and you should find HDPOAuthConnect.mez file. This is the Power BI extension.
- On your PC, Go to Documents and create a folder named Microsoft Power BI Desktop.
- Under the folder Microsoft Power BI Desktop, create another folder Custom Connectors
- Copy the HDPOAuthConnect.mez to the folder Custom Connectors
Connect to your data
- If your Power BI is already running, save your work and Restart Power BI for the extension to show up.
- In Power BI, click on Get Data -> All -> HDPAOuthConnect. Choose it and you should now see a form as shown below where it will ask you to sign in.
- Click on Sign in and you should now see a login page for DataDirect Hybrid Data Pipeline.
- Login with your credentials, and you should now see the below authorization screen. Click on Allow.
- You should now be back on Power BI Sign in form, you should now be signed in. Click on Connect to see your data.
We hope this tutorial helped you to access your data securely using OData generated by Progress Hybrid Data Pipeline from Power BI. You can use Hybrid Data Pipeline in a similar fashion to connect to Oracle, Postgres, MySQL, DB2 etc., and even if they are On-premise you would be able to access the data from Power BI. If you have any questions or issues, feel free to contact us.