Create and manage integration accounts for B2B enterprise integrations in Azure Logic Apps

• 07/26/2019
• 7 minutes to read
• • 
  • 
  • 
  • 
  • 
  • +2

Before you can build enterprise integration and B2B solutions by using Azure Logic Apps, you need to create an integration account, which is a separate Azure resource that provides a secure, scalable, and manageable container for the integration artifacts that you define and use with your logic app workflows.

For example, you can create, store, and manage B2B artifacts, such as trading partners, agreements, maps, schemas, certificates, and batch configurations. Also, before your logic app can work with these artifacts and use the Logic Apps B2B connectors, you must link your integration account to your logic app. Both your integration account and logic app must exist in the same location or region.

This topic shows you how to perform these tasks:

• Create your integration account.
• Link your integration account to a logic app.
• Change the pricing tier for your integration account.
• Unlink your integration account from a logic app.
• Move your integration account to another Azure resource group or subscription.
• Delete your integration account.

Prerequisites

• An Azure subscription. If you don't have an Azure subscription, sign up for a free Azure account.

Create integration account

For this task, you can use either the Azure portal by following the steps in this section, Azure PowerShell, or Azure CLI.

1. Sign in to the Azure portal with your Azure account credentials.

2. On the main Azure menu, select Create a resource. In the search box, enter "integration account" as your filter, and select Integration Account.

   

3. Under Integration Account, select Create.

   

4. Provide this information about your integration account:

   

   Property	Required	Value	Description
   Name	Yes	<integration-account-name>	Your integration account's name, which can contain only letters, numbers, hyphens (-), underscores (_), parentheses ((, )), and periods (.). This example uses "Fabrikam-Integration".
   Subscription	Yes	<Azure-subscription-name>	The name for your Azure subscription
   Resource group	Yes	<Azure-resource-group-name>	The name for the Azure resource group to use for organizing related resources. For this example, create a new resource group with the name "FabrikamIntegration-RG".
   Pricing Tier	Yes	<pricing-level>	The pricing tier for the integration account, which you can change later. For this example, select Free. For more information, see these topics: - Logic Apps pricing model - Logic Apps limits and configuration - Logic Apps pricing
   Location	Yes	<Azure-region>	The region where to store your integration account metadata. Either select the same location as your logic app, or create your logic apps in the same location as your integration account. For this example, use "West US". Note: To create an integration account inside an integration service environment (ISE), select that ISE as the location. For more information, see Create integration accounts in an ISE.
   Log Analytics	No	Off, On	Keep the Off setting for this example.

5. When you're finished, select Create.

   After deployment completes, Azure opens your integration account.

   

6. Before your logic app can use your integration account, follow the next steps to link your integration account and logic app together.

Link to logic app

To give your logic apps access to an integration account that contains your B2B artifacts, you must first link your integration account to your logic app. Both logic app and integration account must exist in the same region. To complete this task, you can use the Azure portal. If you use Visual Studio and your logic app is in an Azure Resource Group project, you can link your logic app to an integration account by using Visual Studio.

1. In the Azure portal, find and open your logic app.

2. In the Azure portal, open an existing logic app or create a new logic app.

3. On your logic app's menu, under Settings, select Workflow settings. Under Integration account, open the Select an Integration account list. Select the integration account to link to your logic app.

   

4. To finish linking, select Save.

   

   After your integration account is successfully linked, Azure shows a confirmation message.

   

Now your logic app can use the artifacts in your integration account plus the B2B connectors, such as XML validation and flat file encoding or decoding.

Change pricing tier

To increase the limits for an integration account, you can upgrade to a higher pricing tier, if available. For example, you can upgrade from the Free tier to the Basic tier or Standard tier. You can also downgrade to a lower tier, if available. For more information pricing information, see these topics:

• Logic Apps pricing
• Logic Apps pricing model

Upgrade pricing tier

To make this change, you can use either the Azure portal by following the steps in this section or the Azure CLI.

Azure portal

1. Sign in to the Azure portal with your Azure account credentials.

2. In the main Azure search box, enter "integration accounts" as your filter, and select Integration accounts.

   

   Azure shows all the integration accounts in your Azure subscriptions.

3. Under Integration accounts, select the integration account that you want to move. On your integration account menu, select Overview.

   

4. On the Overview pane, select Upgrade pricing tier, which lists any available higher tiers. When you select a tier, the change immediately takes effect.

Azure CLI

1. If you haven't done so already, install the Azure CLI prerequisites.

2. In the Azure portal, open the Azure Cloud Shell environment.

   

3. At the command prompt, enter the az resource command, and set skuName to the higher tier that you want.

   az resource update --resource-group {ResourceGroupName} --resource-type Microsoft.Logic/integrationAccounts --name {IntegrationAccountName} --subscription {AzureSubscriptionID} --set sku.name={SkuName}
   

   For example, if you have the Basic tier, you can set skuName to Standard:

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Standard
   

Downgrade pricing tier

To make this change, use the Azure CLI.

1. If you haven't done so already, install the Azure CLI prerequisites.

2. In the Azure portal, open the Azure Cloud Shell environment.

   

3. At the command prompt, enter the az resource command and set skuName to the lower tier that you want.

   az resource update --resource-group <resourceGroupName> --resource-type Microsoft.Logic/integrationAccounts --name <integrationAccountName> --subscription <AzureSubscriptionID> --set sku.name=<skuName>
   

   For example, if you have the Standard tier, you can set skuName to Basic:

   az resource update --resource-group FabrikamIntegration-RG --resource-type Microsoft.Logic/integrationAccounts --name Fabrikam-Integration --subscription XXXXXXXXXXXXXXXXX --set sku.name=Basic
   

Unlink from logic app

If you want to link your logic app to another integration account, or no longer use an integration account with your logic app, delete the link by using Azure Resource Explorer.

1. Open your browser window, and go to Azure Resource Explorer (https://resources.azure.com). Sign in with the same Azure account credentials.

   

2. In the search box, enter your logic app's name so that you can find and select your logic app.

   

3. On the explorer title bar, select Read/Write.

   

4. On the Data tab, select Edit.

   

5. In the editor, find the integrationAccount object, and delete that property, which has this format:

   {
      // <other-attributes>
      "integrationAccount": {
         "name": "<integration-account-name>",
         "id": "<integration-account-resource-ID>",
         "type": "Microsoft.Logic/integrationAccounts"  
   },
   

   For example:

   

6. On the Data tab, select Put to save your changes.

   

7. In the Azure portal, find and select your logic app. Under your app's Workflow settings, check that the Integration account property now appears empty.

   

Move integration account

You can move your integration account to another Azure resource group or Azure subscription. When you move resources, Azure creates new resource IDs, so make sure that you use the new IDs instead and update any scripts or tools associated with the moved resources. If you want to change the subscription, you must also specify an existing or new resource group.

For this task, you can use either the Azure portal by following the steps in this section or the Azure CLI.

1. Sign in to the Azure portal with your Azure account credentials.

2. In the main Azure search box, enter "integration accounts" as your filter, and select Integration accounts.

   

   Azure shows all the integration accounts in your Azure subscriptions.

3. Under Integration accounts, select the integration account that you want to move. On your integration account menu, select Overview.

   

4. Next to either Resource group or Subscription name, select change.

   

5. Select any related resources that you also want to move.

6. Based on your selection, follow these steps to change the resource group or subscription:

   • Resource group: From the Resource group list, select the destination resource group. Or, to create a different resource group, select Create a new resource group.

   • Subscription: From the Subscription list, select the destination subscription. From the Resource group list, select the destination resource group. Or, to create a different resource group, select Create a new resource group.

7. To acknowledge your understanding that any scripts or tools associated with the moved resources won't work until you update them with the new resource IDs, select the confirmation box, and then select OK.

8. After you finish, make sure that you update any and all scripts with the new resource IDs for your moved resources.

Delete integration account

For this task, you can use either the Azure portal by following the steps in this section, Azure CLI, or Azure PowerShell.

1. Sign in to the Azure portal with your Azure account credentials.

2. In the main Azure search box, enter "integration accounts" as your filter, and select Integration accounts.

   

   Azure shows all the integration accounts in your Azure subscriptions.

3. Under Integration accounts, select the integration account that you want to delete. On your integration account menu, select Overview.

   

4. On the Overview pane, select Delete.

   

5. To confirm that you want to delete your integration account, select Yes.

   

Next steps

• Create trading partners in your integration account
• Create agreements between partners in your integration account