FinOps Business Event connection with Azure APIM – LogicApps

1. First we need to create LogicApp, for that we need to login to https://portal.azure.com/ and Select Logic apps.
2. 
3. 
4. Select Blank Logic App
5. 
6. Search HTTP and select the trigger When a HTTP request is received.
7. 
8. Now open your finance and operations environment.
9. Navigate to System administration > Setup > Business events > Business events catalog
10. Here we are using Purchase order confirmed business event for demo purpose you can select your own business event.
11. Click on Purchase order confirmed business event, Click on Download schema button to download payload schema.
12. 
13. It will download the payload schema file open that file and copy its content.
14. 
15. Go back to your Logic app designer, click on Use sample payload to generate schema link.
16. 
17. Paste the payload schema and click Done.
18. 
19. Add another action in your Logic App to show the data, click on +New Step button and search for Compose action
20. Select Body of When a HTTP request is received action in Input field of Compose action and save logic app.
21. 
22. After creating a Logic App we need to create the Azure APIM (API Management) from Azure Portal.
23. Search for API Management services, Create new.
24. 
25. 
26. 
27. APIM will take some time like 30 minutes something to delpoy, be patient till APIM is deployed succesfully.
28. 
29. Click on API menu.
30. 
31. Select Logic App tile.
32. 
33. Click on Browse and select the logic app you created in this article before.
34. 
35. 
36. 
37. Click on FinOps-BusinessEvent and then manual-invoke and then Test.
38. 
39. Copy the Request URL and Ocp-Apim-Subscription-Key and save them somewhere for future.
40. After creating a APIM, we need to create the App Registration for authentication in Azure Portal.
41. 
42. 
43. Copy Application (client) ID of App Registration somewhere for future.
44. Click on Certificates & secrets menu, and add the secret.
45. 
46. Click on New client secret button and give secret name and validity and click Add.
47. 
48. Copy Secret Value somewhere for future.
49. 
50. After App Registration, we need to create Key vault in Azure Portal.
51. 
52. 
53. Copy Vault URI somewhere for future and then click on the Access policies menu.
54. 
55. Click on Add Access Policy button.
56. 
57. Select Key & Secret Management in Configure from template (optional)
58. Click on None selected in Select principal, it will open pop up form enter the Application (client) ID of App Registration which you saved in point number 43. It will search the App registration select it and click on Select button.
59. After that click on Add button.
60. 
61. Click the Save button then to save the access policy.
62. 
63. After saving the access policy on key vault, create Secret on Key vault. To create secret click on Secrets menu.
64. Click on Generate/Import button.
65. 
66. Give the appropriate name to the secret and save it somewhere for future use.
67. The Value of secret should be <APIM endpoint URL>?subscription-key=<APIM endpoint subscription key>
68. <APIM endpoint URL> is the value which you saved on point 39 as Request URL.
69. <APIM endpoint subscription key> is the value which you saved on point 39 as Ocp-Apim-Subscription-Key.
70. Click on Create button to create Secret.
71. 
72. After saving Key vault secret all Azure configuration is done now.
73. Go to your FinOps environment again.
74. Navigate to System administration > Setup > Business events > Business events catalog > Endpoints
75. Click on New button to create a new endpoint.
76. 
77. Select endpoint type as HTTPS and click Next.
78. 
79. 
80. Give the appropriate name and description for an endpoint.
81. In Azure Active Directory application, paste the Application (client) ID of App Registration which you saved in point number 43.
82. In Azure Application secret, paste the value which you saved in point number 48.
83. In Key Vault DNS Name, paste the Vault URI which you saved in point number 53.
84. In Key Vault Secret Name, paste the value which you saved in point number 66.
85. 
86. After end point is configured in FinOps, go to Business event catalog tab and select the Purchase order confirmed business event and click on Activate button.
87. 
88. Select the legal entity and the endpoint which you just created and click OK.
89. 
90. Check in Activate business events tab that the business event is activated or not.
91. 
92. All configurations are completed. In order to trigger the business event we need to confirm the purchase order in order to trigger the business event.
93. Go to FinOps and navigate to Accounts payable > Purchase orders > All purchase orders
94. Select the purchase and click Confirm button.
95. 
96. 
97. Purchase order is confirmed. Now lets see if the payload of business event is sent to the logic app via APIM or not.
98. 
99. 

We successfully passed the business event payload of FinOps to the Logic app via APIM.

Thank you for reading this article hope you find it useful.

Omar Iqbal

Technical Consultant