Add resources to your integration service environment (ISE) in Azure Logic Apps

After you create an integration service environment (ISE), add resources such as logic apps, integration accounts, and connectors so that they can access the resources in your Azure virtual network. For example, managed ISE connectors that become available after you create your ISE don't automatically appear in the Logic App Designer. Before you can use these ISE connectors, you have to manually add and deploy those connectors to your ISE so that they appear in the Logic App Designer.

Important

For logic apps and integration accounts to work together in an ISE, both must use the same ISE as their location.

Prerequisites

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

  • The ISE that you created to run your logic apps. If you don't have an ISE, create an ISE first.

  • To create, add, or update resources that are deployed to an ISE, you need to be assigned the Owner or Contributor role on that ISE, or you have permissions inherited through the Azure subscription or Azure resource group associated with the ISE. For people who don't have owner, contributor, or inherited permissions, they can be assigned the Integration Service Environment Contributor role or Integration Service Environment Developer role. For more information, see What is Azure role-based access control (Azure RBAC)?

Create logic apps

To build logic apps that run in your integration service environment (ISE), follow these steps:

  1. Find and open your ISE, if not already open. From the ISE menu, under Settings, select Logic apps > Add.

    Add new logic app to ISE

  2. Provide information about the logic app that you want to create, for example:

    Screenshot that shows the "Logic App" "Create" window with example information entered.

    Property Required Description
    Name Yes The name for the logic app to create
    Subscription Yes The name for the Azure subscription to use
    Resource group Yes The name for the Azure resource group (new or existing) to use
    Location Yes Under Integration service environments, select the ISE to use, if not already selected.

    Important: To use your logic apps with an integration account, both must use the same ISE.

  3. When you're done, select Create.

  4. Continue creating your logic app in the usual way.

    For differences in how triggers and actions work and how they're labeled when you use an ISE compared to the multi-tenant Logic Apps service, see Isolated versus multi-tenant in the ISE overview.

  5. To manage logic apps and API connections in your ISE, see Manage your integration service environment.

Create integration accounts

Based on the ISE SKU selected at creation, your ISE includes specific integration account usage at no additional cost. Logic apps that exist in an integration service environment (ISE) can reference only integration accounts that exist in the same ISE. So, for an integration account to work with logic apps in an ISE, both the integration account and logic apps must use the same environment as their location. For more information about integration accounts and ISEs, see Integration accounts with ISE.

To create an integration account that uses an ISE, follow these steps:

  1. Find and open your ISE, if not already open. From the ISE menu, under Settings, select Integration accounts > Add.

    Add new integration account to ISE

  2. Provide information about the logic app that you want to create, for example:

    Select integration service environment

    Property Required Description
    Name Yes The name for the integration account that you want to create
    Subscription Yes The name for the Azure subscription that you want to use
    Resource group Yes The name for the Azure resource group (new or existing) to use
    Pricing tier Yes The pricing tier to use for the integration account
    Location Yes Under Integration service environments, select the same ISE that your logic apps use, if not already selected.

    Important: To use your integration account with logic apps, both must use the same ISE.

  3. When you're done, select Create.

  4. Link your logic app to your integration account in the usual way.

  5. Continue by adding resources to your integration account, such as trading partners and agreements.

  6. To manage integration accounts in your ISE, see Manage your integration service environment.

Add ISE connectors

After you create your ISE, managed ISE connectors don't automatically appear in the connector picker on the Logic App Designer. Before you can use these ISE connectors, you have to manually add and deploy these connectors to your ISE so that they appear in the Logic App Designer.

Important

Managed ISE connectors currently don't support tags. If you set up a policy that enforces tagging, trying to add ISE connectors might fail with an error similar to this example:

{
   "error": { 
      "code": "IntergrationServiceEnvironmentManagedApiDefinitionTagsNotSupported", 
      "message": "The tags are not supported in the managed API 'azureblob'."
   }
}

So, to add ISE connectors, you have to either disable or remove your policy.

  1. On your ISE menu, under Settings, select Managed connectors. On the toolbar, select Add.

    View managed connectors

  2. On the Add a new managed connector pane, open the Find connector list. Select the ISE connector that you want to use but isn't yet deployed in your ISE. Select Create.

    Select the ISE connector that you want to deploy in your ISE

    Only ISE connectors that are eligible but not yet deployed to your ISE appear available for you to select. Connectors that are already deployed in your ISE appear unavailable for selection.

Create custom connectors

To use custom connectors in your ISE, create those custom connectors from directly inside your ISE.

  1. Find and open your ISE, if not already open. From the ISE menu, under Settings, select Custom connectors > Add.

    Create custom connector

  2. Provide the name, Azure subscription, and Azure resource group (new or existing) to use for your custom connector.

  3. From the Location list, under the Integration service environments section, select the same ISE that your logic apps use, and select Create, for example:

    Screenshot that shows the "Create Logic Apps Custom Connector" window with example information selected.

  4. Select your new custom connector, and then select Edit, for example:

    Select and edit custom connector

  5. Continue by creating the connector in the usual way from an OpenAPI definition or SOAP.

  6. To manage custom connectors in your ISE, see Manage your integration service environment.

Next steps