Create and manage integration accounts for B2B workflows in Azure Logic Apps with the Enterprise Integration Pack

1. In the Azure portal search box, enter integration accounts, and select Integration accounts.

2. Under Integration accounts, select Create.

3. On the Create an integration account pane, provide the following information about your integration account:

   Property	Required	Value	Description
   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 named FabrikamIntegration-RG.
   Integration account 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.
   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, review the following documentation: - Logic Apps pricing model - Logic Apps limits and configuration - Logic Apps pricing
   Storage account	Available only for the Premium (preview) integration account	None	The name for an existing Azure storage account. For the example in this guide, this option doesn't apply.
   Region	Yes	<Azure-region>	The Azure region where to store your integration account metadata. Either select the same location as your logic app resource, or create your logic apps in the same location as your integration account. For this example, use West US. To use your integration account with an integration service environment (ISE), select Associate with integration service environment, and then select your ISE as the location. To create an integration account from inside an ISE, see Create integration accounts from inside an ISE. Note: The ISE resource will retire on August 31, 2024, due to its dependency on Azure Cloud Services (classic), which retires at the same time. Currently in preview, the capability is available for you to export a Standard integration account for an ISE to a Premium integration account.
   Enable log analytics	No	Unselected	For this example, don't select this option.

4. When you're done, select Review + create.

   After deployment completes, Azure opens your integration account.

5. If you created a Premium integration account, make sure to set up access to the associated Azure storage account.

Prepare your environment for the Azure CLI

• Use the Bash environment in Azure Cloud Shell. For more information, see Quickstart for Bash in Azure Cloud Shell.

  

• If you prefer to run CLI reference commands locally, install the Azure CLI. If you're running on Windows or macOS, consider running Azure CLI in a Docker container. For more information, see How to run the Azure CLI in a Docker container.

  • If you're using a local installation, sign in to the Azure CLI by using the az login command. To finish the authentication process, follow the steps displayed in your terminal. For other sign-in options, see Sign in with the Azure CLI.

  • When you're prompted, install the Azure CLI extension on first use. For more information about extensions, see Use extensions with the Azure CLI.

  • Run az version to find the version and dependent libraries that are installed. To upgrade to the latest version, run az upgrade.

1. To add the az logic integration-account extension, use the az extension add command:

   az extension add –-name logic
   

2. To create a resource group or use an existing resource group, run the az group create command:

   az group create --name myresourcegroup --location westus
   

   To list the integration accounts for a resource group, use the az logic integration-account list command:

   az logic integration-account list --resource-group myresourcegroup
   

3. To create an integration account, run the az logic integration-account create command:

   az logic integration-account create --resource-group myresourcegroup \
       --name integration_account_01 --location westus --sku name=Standard
   

   Your integration account name can contain only letters, numbers, hyphens (-), underscores (_), parentheses (()), and periods (.).

   To view a specific integration account, use the az logic integration-account show command:

   az logic integration-account show --name integration_account_01 --resource-group myresourcegroup
   

   You can change your SKU, or pricing tier, by using the az logic integration-account update command:

   az logic integration-account update --sku name=Basic --name integration_account_01 \
       --resource-group myresourcegroup
   

   For more information about pricing, see these resources:

   • Azure Logic Apps pricing model
   • Azure Logic Apps limits and configuration
   • Azure Logic Apps pricing

To import an integration account by using a JSON file, use the az logic integration-account import command:

az logic integration-account import --name integration_account_01 \
    --resource-group myresourcegroup --input-path integration.json

This section describes how to complete this task using 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, open your logic app resource.

2. On your logic app's navigation menu, under Settings, select Workflow settings. Under Integration account, open the Select an Integration account list, and select the integration account you want.

   

3. To finish linking, select Save.

   

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

   

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

Find your integration account's callback URL

Before you can link your integration account to a Standard logic app resource, you need to have your integration account's callback URL.

1. In the Azure portal search box, enter integration accounts, and then select Integration accounts.

2. From the Integration accounts list, select your integration account.

3. On your selected integration account's navigation menu, under Settings, select Callback URL.

4. Find the Generated Callback URL property value, copy the value, and save the URL to use later for linking.

Link integration account to Standard logic app

Azure portal

1. In the Azure portal, open your Standard logic app resource.

2. On your logic app's navigation menu, under Settings, select Environment variables.

3. On the Environment variables page, check whether the app setting named WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL exists.

4. If the app setting doesn't exist, at the end of the settings list, add a new app setting by entering the following:

   Property	Value
   Name	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Value	<integration-account-callback-URL>

5. When you're done, select Apply.

Visual Studio Code

1. From your Standard logic app project in Visual Studio Code, open the local.settings.json file.

2. In the Values object, add an app setting that has the following properties and values, including the previously saved callback URL:

   Property	Value
   Name	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Value	<integration-account-callback-URL>

   This example shows how a sample app setting might appear:

   {
       "IsEncrypted": false,
       "Values": {
           "AzureWebJobStorage": "UseDevelopmentStorage=true",
           "FUNCTIONS_WORKER_RUNTIME": "node",
           "WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL": "https://prod-03.westus.logic.azure.com:443/integrationAccounts/...."
       }
   }
   

3. When you're done, save your changes.

1. In the Azure portal search box, enter integration accounts, and select Integration accounts.

   Azure shows all the integration accounts in your Azure subscriptions.

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

   

3. On the Overview page, select Upgrade Pricing Tier, which lists any available higher tiers. When you select a tier, the change immediately takes effect.

   

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
   

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 to find and open 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, which has the following format, and delete the object:

   {
      // <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, open your logic app. On your logic app menu, under Workflow settings, confirm that the Integration account property now appears empty.

   

Azure portal

1. In the Azure portal, open your Standard logic app resource.

2. On your logic app menu, under Settings, select Environment variables.

3. On the Environment variables page, find the app setting named WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL.

4. Clear the app setting name and its value.

5. When you're done, select Apply.

Visual Studio Code

1. From your Standard logic app project in Visual Studio Code, open the local.settings.json file.

2. In the Values object, find and delete the app setting that has the following properties and values:

   Property	Value
   Name	WORKFLOW_INTEGRATION_ACCOUNT_CALLBACK_URL
   Value	<integration-account-callback-URL>

3. When you're done, save your changes.

1. In to the Azure portal search box, enter integration accounts, and select Integration accounts.

   Azure shows all the integration accounts in your Azure subscriptions.

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

   

3. On the Overview page, select Delete.

   

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

   

You can delete an integration account by using the az logic integration-account delete command:

az logic integration-account delete --name integration_account_01 --resource-group myresourcegroup