In this article:

  1. Introduction to configuring Azure Service Bus Namespaces
  2. Creating a namespace in Azure portal
  3. Obtain the management credentials
  4. Associating Namespace in your ServiceBus360 account
  5. Import Namespaces configured in Service Bus Explorer

Introduction to configuring Azure Service Bus Namespaces

When a user logs into the ServiceBus360 account for the first time, a "Welcome Message" is displayed. Click the Get Started button to associate/import namespaces to ServiceBus360. Based on the license plan, namespace type and the number of namespaces that can be associated in ServiceBus360 will vary. In the free account, the user can associate 1 namespace in each type (Messaging Namespace, Relay Namespace, Event Hub Namespace) and monitor up to 2 Entities in each Namespace. The first step in getting started with ServiceBus360 account is by associating Azure Service Bus namespace to manage within ServiceBus360. In this article, we will have a detailed look into the steps to associate/import Azure Service Bus namespace in ServiceBus360. Free account, the user can associate 1 namespace in each type (Messaging Namespace, Relay Namespace, Event Hub Namespace) and monitor up to 2 Entities in each Namespace. The first step in getting started with ServiceBus360 account is by associating Azure Service Bus namespace to manage within ServiceBus360. In this article, we will have a detailed look into the steps to associate/import Azure Service Bus namespace in ServiceBus360.

34MMGGm8P17plIqsJdH1XK2LVFrDRYxI3g.png


ServiceBus360 allows the Account Owner/Super Users to associate Azure Namespaces to their ServiceBus360 account. When the user logs into the ServiceBus360 account for the first time, the dashboard will not have any Namespace associated. The Account Owner/Super Users need to associate the Namespace in ServiceBus360 that they wish to manage and monitor. To begin using ServiceBus360, you must first create a namespace in Azure and obtain the management credentials. A namespace provides a scoping container for addressing Service Bus entities within your application.

Creating a namespace in Azure

To create a namespace:

  1. Log into the Azure portal
  2. In the left navigation pane of the portal, click New, then click Enterprise Integration, and then click Service Bus
  3. In the Create Namespace dialog, enter a namespace name. The system immediately checks to see if the name is available
  4. After making sure the namespace name is available, choose the pricing tier (Basic, Standard, or Premium)
  5. In the Subscription field, choose an Azure subscription in which the namespace has to be created
  6. In the Resource group field, choose an existing resource group to which the namespace will belong to, or create a new one
  7. In Location, choose the country or region in which your namespace should be hosted

  8. Click Create. The system now creates your namespace and enables it. You might have to wait several minutes as the system provisions resources for your account

Obtain the management credentials

  1. In the list of namespaces, click the newly created namespace name
  2. In the namespace blade, click Shared access policies
  3. In the Shared access policies blade, click RootManageSharedAccessKey. We recommend you to create a new Shared Access Policy with the name - ServiceBus360. Enable all the three claims - Manage, Send & Listen. You can use this policy to associate the namespace with ServiceBus360.

  4. In the Policy: RootManageSharedAccessKey blade, click the Copy button next to Connection string–primary key, to copy the connection string to your clipboard for later use. Paste this value into Notepad or a clipboard to associate this connection string in ServiceBus360.

Associating Namespace in your ServiceBus360 account

Method 1:

  1. Log into the ServiceBus360 account (as Account Owner/Super User)
  2. From the Home Dashboard, click the Associate Namespace button to directly navigate to the Associate Namespace blade.
  3. In the Associate Namespace blade, enter the following details:
    1. Friendly Name - It is an alias name of the Azure Namespace. This friendly name is valid only within ServiceBus360.
    2. Connection String - Enter the Connection String value, this is available in the Azure portal. A Connection String with Manage claims policy is necessary to operate on Azure Namespaces.
    3. Azure Namespace - This field is automatically filled once the correct Connection String is filled in the above field
    4. Select Azure Namespace Type - Select the appropriate namespace type as created in the Azure portal. Selecting wrong namespace type would not display the appropriate result.
  4. Click the Save button to complete the process and associate the namespace in ServiceBus360.
  5. Successfully associated Namespace will be listed in the Namespaces screen
    Note: When a namespace status is changed to the error state, it will be reflected in ServiceBus360 only in the next WebJobs cycle.
  6. You can view the confirmation message from the Notification section

Method 2:

  1. Log into your ServiceBus360 account (as Account Owner/Super User)
  2. From the Home Dashboard, click the Settings icon to navigate to the ServiceBus360 Settings section
  3. Click the Namespace icon from the left side navigation panel
  4. Click the Associate Namespace button to open the Associate Namespace blade
  5. In the Associate Namespace blade, enter the following details:
    1. Friendly Name - It is an alias name of the Azure Namespace. This friendly name is valid only within ServiceBus360.
    2. Connection String - Enter the Connection String value, this is available in the Azure portal. A Connection String with Manage claims policy is necessary to operate on Azure Namespaces.
    3. Azure Namespace - This field is automatically filled once the correct Connection String is filled in the above field
    4. Select Azure Namespace Type - Select the appropriate namespace type as created in the Azure portal. Selecting wrong namespace type would not display the corresponding entities.
  6. Click the Save button to complete the process and associate the namespace in ServiceBus360.
  7. You can view the confirmation message from the Notification section


Import Namespaces configured in Service Bus Explorer

In this section, we will see the different options to import an Azure Service Bus namespace configured in Service Bus Explorer to ServiceBus360. Let's consider a scenario, ACME corporation has created and configured the settings for a Queue in their test environment and wants to replicate the same in the development environment, in this scenario, the only option is to recreate the Queues with the same settings either in the Azure portal or in Service Bus Explorer. Obviously, this is a time-consuming process, ServiceBus360 provides a simple solution by allowing the users to import the Queues between namespace to make process easy.

  1. Log into your ServiceBus360 account
  2. In the home dashboard screen, click the Manage Namespace button in the messaging namespace pane to navigate to the Queues dashboard screen.
  3. The Queues dashboard displays the list of Queues available in the namespace. Click the Import button to open the Import Entities blade
  4. Select Import from a file to import the Queues that are exported from Service Bus Explorer as XML file
    1. Click the Browse button to open the file location
    2. Select the file and click Proceed
  5.  To import from another namespace, click the checkbox against Import from other namespace option 
    1. Choose the namespace from the dropdown and select the Queues to import
    2. Click the Proceed button to complete the process
  6. The Queues will be imported along with the configurations