Microsoft Azure Service Bus

Arellia 8.0 or greater solutions support Internet connected clients through Microsoft Azure Service Bus. Service Bus is a subscription service that external agents can connect to and use to communicate with an internal Arellia Management Server (AMS) instance. This document is broken up in two sections:

• Azure Services Bus Configuration
• AMS Services Bus Configuration

Azure Service Bus Configuration

Arellia requires a Service Bus relay for remote communication. To create a new Service Bus, do the following steps:

1. Open the Azure Management Console
2. Select New > App Services > Service Bus > Queue > Custom Create
   
3. Set the Queue Name to "ams" 
4. Set the region to the region closest to AMS
5. Select Create a new namespace and set the namespace to something unique but memorable. The namespace will be used for all incoming communication. 
   
6. Click next and uncheck "Enable Partitioning" on the second configure page. 
   
7. Click the Check-mark to create the service bus. 
8. Select the new Service Bus instance and then select Connection Information at the bottom of the page.
   
9. Use the RootManagedSharedAccessKey for the AMS Service Bus Configuration.

Back to top

AMS Service Bus Configuration 

To configure a Service Bus instance with a custom URL and credentials for the AMS to connect with, do the following steps:

1. In the Arellia Security Manager Console, click the Configuration tab.
   
2. In the directory in the left sidebar, navigate to Foreign Software Systems > User Credentials 
3. Select New > User Credential and set the Name to ServiceBus User Credential
4. Set the Account name to RootManagedSharedAccessKey and set the Password to the Shared Access Key obtained from step 9 above.
5. Save the user credential
6. In the directory in the left sidebar, navigate to Foreign Software Systems > Foreign Software System Types > Azure Service Bus.
   
7. In the Windows Azure Service Bus  pane, click the New button.
8. Then when the option drops down, click Azure Service Bus Instance. 
   
9. In the Arellia Security Manager - Create Item dialog box, enter the name of the Service Bus (the namespace created in step 5 of the Azure Configuration) and click OK.
   
10. In the Security Manager dialog box that opens, set the Shared policy credential to the Service Bus User Credential created in step 3.
11. Set the Queue name to "ams" or the queue name used in step 3 of the Azure Configuration   
12. Set the Shared access policy name to RootManagedSharedAccessKey and the Shared access  key to the key used in step 4 for the password of the Service Bus User Credential.
    
13. Click Save .
14. Right-click the newly created Service Bus instance and select Enable.
15. Recycle the AmsWorker application pool for the new settings to be applied.

Back to top

Agents can then be configured to connect to the Service Bus and communicate with AMS by Setting the Arellia Management Server Address to the Service Bus Address.