FinOps Business Event connection with Azure APIM – Azure Function

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

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

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

Omar Iqbal

Technical Consultant