In
order to use the workflow components for Azure Service Bus, you first
need to create an app registration in Microsoft Entra Admin Center: https://entra.microsoft.com/
- From the left side menu, navigate to Applications -> App registrations -> New registration.
- On
this screen, enter a suitable name for the app, for instance
"InterForm" and select "Accounts in this organizational directory only
(XXX.XXX only - Single tenant)". Leave "redirect URI" undefined and
press the "Register" button.
- An
Application (client) ID and Directory (tenant) ID have been generated
for you. Now click the link "Add a certificate or secret" next
to "Client credentials".
- Under
"Client Secrets" use the "New client secret" button to create a secret.
Select any expiry time that you like, but note that you have to create a
new secret when it expires.
- Now
that you have created a secret, immediately make a copy of the value in
the "Value" column, as you will not be able to see this again later.
Next
you need to assign permissions to the app registration on the Azure
Portal. This process can be scripted, but this is outside the scope of
this document. Below is a description of how to do it manually on https://portal.azure.com/
- Find and select the Service Bus namespace that you want to use.
- Select "Access control (IAM)", then Add → Add role assignment.
- If you want to be able to receive messages from the service bus, then select the role "Azure Service Bus Data Receiver".
If you want to be able to send messages to the service bus, then select the role "Azure Service Bus Data Sender".
If you want to be able to both send and receive, then repeat this procedure twice to assign both roles. - Select Next → select members. Here type the name of the previously created app registration and select it.
- Now use the button "Review + assign" two times to complete the process.
Finally the connection must be configured in the InterFormNG2 tenant settings.
- Add a new instance under "Azure Service Bus".
- In
the section "Microsoft Entra ID app registration", enter the client ID,
directory ID and secret from the previously created Entra ID app
registration.