Table of Contents |
---|
How to Set Up Configuration
Being signed in to your ServiceNow instance, open the Scheduled Jobs module.
Locate and open the Scheduled Generation based on Power BI Connector Auth record.
Select Execute Now.
Open the Application Registry module.
Find and open the Power BI Connector Auth record.
In the navigator box, enter the sys_properties.LIST, and then hit Enter.
Info |
---|
The sys_properties.LIST will be automatically opened in a new tab. |
Find and open x_acsof_power_bi_s.x_acsoft.pbi.client_secret.
Info |
---|
Now you should have two tabs open: Power BI Connector Auth and x_acsof_power_bi_s.x_acsoft.pbi.client_secret |
Return to the Power BI Connector Auth page, select the padlock icon, and then copy Client Secret (It will be opened after selecting the padlock icon).
Return to the x_acsof_power_bi_s.x_acsoft.pbi.client_secret page.
Paste the copied Client Secret into the Value field, and then select Update.
Find and open x_acsof_power_bi_s.x_acsoft.pbi.client_id (on the same page - sys_properties.LIST).
Return to the Power BI Connector Auth page, and then copy the Client ID value.
Return to the x_acsof_power_bi_s.x_acsoft.pbi.client_id page.
Paste the copied Client ID into the Value field, and then select Update.
Return to the Power BI Connector Auth page, and then select New.
Info |
---|
Make sure that you are on the Jwt Verifie Map tab. |
In the *Name field, enter the preferable name for your Jwt Verifier Map, and then select Submit.
Generate JKS and OpenSSL certificate by following these guides:
Before starting, ensure that you have an admin role and installed OpenSSL on your machine.
Info |
---|
When all steps are done, the following list of files will appear:
|
Open newly-created Jwt Verifier Map record.
Info |
---|
It was created in step 12. |
Select Lookup using list.
Info |
---|
The new tab - X.509 Certificates - will be opened. |
Select New.
In the *Name field, enter your certificate name.
Fill in the Format and Type fields as shown in the screenshot.
Open the publickey.cer file using a text editor.
Copy its data, paste it into the PEM Certificate field, and then select Submit.
Open JWT Providers, and then open the pbi jwt provider record.
Copy the Client ID (from Power BI Connector Auth), and then paste it into the Claim Value fields of the aud and iss records.
Select the info icon of the Signing Configuration field, and then select Open Record.
Select Lookup using list of the Signing Keystore field.
Info |
---|
The new tab - X.509 Certificates - will be opened. |
Select New.
In the Type field, select Java Key Store.
In the *Name field, enter the name of your certificate.
In the Key store password field, enter your key store password of the .jks file.
Select the clip icon, and then select your .jks file.
Select Submit.
Info |
---|
The newly-created record will be automatically added to Power BI JWT Key. |
Ensure the Signing Keystore field contains the correct record, and then select Update.
How to Test Configuration
Open Scripts - Background.
Paste the following script with the created values on your instance, and then select Run script.
Info |
---|
Values that have to be substituted are highlighted with green color on the screenshot below. |
Expand | ||
---|---|---|
| ||
|
Expand | ||
---|---|---|
| ||
|
Info |
---|
After the script is finished, the JWT (JSON Web Token) will be generated. |
Open Postman, select the POST method, and then enter the following URL:
https://your_instance_name/oauth_token.do
where your_instance_name is the name of your ServiceNow instance.
Select Body, select the x-www-form-urlencoded format, and then enter the following variables:
client_id - Application Registry → Power BI Connector Auth → Client ID
client_secret - Application Registry → Power BI Connector Auth → Client Secret
grant_type - urn:ietf:params:oauth:grant-type:jwt-bearer
assertion: JWT generated by the background script in the ServiceNow instance