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

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.

Tip

To create an integration account inside an integration service environment, see Create integration accounts in an ISE.

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

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.

    Create new integration account

  3. Under Integration Account, select Create.

    Choose "Add" to create integration account

  4. Provide this information about your integration account:

    Provide integration account details

    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.

    Azure opens 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.

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.

    Select your integration account

  4. To finish linking, select Save.

    Select your integration account

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

    Azure confirms successful link

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:

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.

    Find integration account

    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.

    On 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.

    Open Azure Cloud Shell

  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.

    Open Azure Cloud Shell

  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
    

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.

    Azure Resource Explorer

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

    Find and select logic app

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

    Turn on "Read/Write" mode

  4. On the Data tab, select Edit.

    On "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:

    Find "integrationAccount" object

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

    To save changes, select "Put"

  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.

    Check that integration account is not linked

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.

    Find integration account

    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.

    On integration account menu, select "Overview"

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

    Change resource group or subscription

  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.

    Find integration account

    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.

    On integration account menu, select "Overview"

  4. On the Overview pane, select Delete.

    On "Overview" pane, select "Delete"

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

    To confirm delete, select "Yes"

Next steps