Autenticar acesso e conexões a recursos do Azure com identidades gerenciadas em Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Padrão)

Quando você usa uma identidade gerenciada para autenticar o acesso ou conexões com recursos protegidos do Microsoft Entra a partir do fluxo de trabalho do aplicativo lógico, não é necessário fornecer credenciais, segredos ou tokens do Microsoft Entra. Nos Aplicativos Lógicos do Azure, algumas operações de conector dão suporte ao uso de uma identidade gerenciada quando você precisa autenticar o acesso a recursos protegidos pela ID do Microsoft Entra. O Azure gerencia essa identidade e ajuda a manter as informações de autenticação seguras porque você não precisa gerenciar essas informações confidenciais. Para obter mais informações, veja O que são identidades geridas para os recursos do Azure?.

Os Aplicativos Lógicos do Azure dão suporte à identidade gerenciada atribuída pelo sistema e à identidade gerenciada atribuída pelo usuário. A lista a seguir descreve algumas diferenças entre esses tipos de identidade gerenciada:

  • Um recurso de aplicativo lógico pode habilitar e usar apenas uma identidade exclusiva atribuída ao sistema.

  • Um recurso de aplicativo lógico pode compartilhar a mesma identidade atribuída pelo usuário em um grupo de outros recursos de aplicativo lógico.

Este guia mostra como concluir as seguintes tarefas:

  • Habilite e configure a identidade gerenciada atribuída ao sistema para seu recurso de aplicativo lógico. Este guia fornece um exemplo que mostra como usar a identidade para autenticação.

  • Crie e configure uma identidade atribuída pelo usuário. Este guia mostra como criar uma identidade atribuída pelo usuário usando o portal do Azure e o modelo do Azure Resource Manager (modelo ARM) e como usar a identidade para autenticação. Para Azure PowerShell, CLI do Azure e API REST do Azure, consulte a seguinte documentação:

Ferramenta Documentação
Azure PowerShell Criar identidade atribuída pelo usuário
CLI do Azure Criar identidade atribuída pelo usuário
API REST do Azure Criar identidade atribuída pelo usuário

Consumo versus aplicativos lógicos padrão

Com base no tipo de recurso do aplicativo lógico, você pode habilitar a identidade atribuída pelo sistema, a identidade atribuída pelo usuário ou ambas ao mesmo tempo:

Aplicação lógica Ambiente Suporte de identidade gerenciado
Consumo - Aplicativos Lógicos do Azure Multitenant

- Ambiente de serviços de integração (ISE)		 - Seu aplicativo lógico pode habilitar a identidade atribuída ao sistema ou a identidade atribuída pelo usuário.

- Você pode usar a identidade gerenciada no nível de recursos do aplicativo lógico e no nível de conexão.

- Se você habilitar a identidade atribuída pelo usuário, seu aplicativo lógico poderá ter apenas uma identidade atribuída pelo usuário de cada vez.
Standard - Aplicativos Lógicos do Azure de locatário único

- Ambiente de Serviço de Aplicativo v3 (ASEv3)

- Aplicativos lógicos habilitados para Azure Arc		 - Você pode habilitar a identidade atribuída pelo sistema, que é habilitada por padrão, e a identidade atribuída pelo usuário ao mesmo tempo.

- Você pode usar a identidade gerenciada no nível de recursos do aplicativo lógico e no nível de conexão.

- Se você habilitar a identidade atribuída pelo usuário, seu recurso de aplicativo lógico poderá ter várias identidades atribuídas pelo usuário ao mesmo tempo.

Para obter informações sobre limites de identidade gerenciada em Aplicativos Lógicos do Azure, consulte Limites em identidades gerenciadas para aplicativos lógicos. Para obter mais informações sobre os tipos de recursos e ambientes do aplicativo lógico Consumo e Padrão, consulte a seguinte documentação:

Onde você pode usar uma identidade gerenciada

Nos Aplicativos Lógicos do Azure, somente operações de conector internas e gerenciadas específicas que dão suporte a OAuth com ID do Microsoft Entra podem usar uma identidade gerenciada para autenticação. As tabelas a seguir fornecem apenas uma seleção de exemplo. Para obter uma lista mais completa, consulte Tipos de autenticação para gatilhos e ações que dão suporte à autenticação e Serviços do Azure que dão suporte à autenticação do Microsoft Entra com identidades gerenciadas.

Para um fluxo de trabalho de aplicativo lógico de consumo, a tabela a seguir lista os conectores que oferecem suporte à autenticação de identidade gerenciada:

Tipo de conector Conectores suportados
Incorporada - Gerenciamento de API do Azure
- Serviços de Aplicativo do Azure
- Azure Functions
- HTTP
- HTTP + Webhook

Observação: as operações HTTP podem autenticar conexões com contas de Armazenamento do Azure por trás de firewalls do Azure com a identidade atribuída ao sistema. No entanto, eles não oferecem suporte à identidade gerenciada atribuída pelo usuário para autenticar as mesmas conexões.
Não gerido - Serviço de Aplicativo do Azure
- Azure Automation
- Armazenamento de Blobs do Azure
- Instância de contêiner do Azure
- Azure Cosmos DB
- Azure Data Explorer
- Azure Data Factory
- Azure Data Lake
- Grade de Eventos do Azure
- Hubs de Eventos do Azure
- Azure IoT Central V2
- Azure IoT Central V3
- Azure Key Vault
- Azure Log Analytics
- Filas do Azure
- Azure Resource Manager
- Barramento de Serviço do Azure
- Azure Sentinel
- Armazenamento de Tabela do Azure
- VM do Azure
- HTTP com Microsoft Entra ID
- SQL Server

Pré-requisitos

Habilitar a identidade atribuída ao sistema no portal do Azure

  1. No portal do Azure, abra seu recurso de aplicativo lógico.

  2. No menu do aplicativo lógico, em Configurações, selecione Identidade.

  3. Na página Identidade, em Sistema atribuído, selecione Ao>salvar. Quando o Azure solicitar a confirmação, selecione Sim.

    Screenshot shows Azure portal, Consumption logic app, Identity page, and System assigned tab with selected options, On and Save.

    Nota

    Se você receber um erro informando que pode ter apenas uma única identidade gerenciada, seu recurso de aplicativo lógico já está associado à identidade atribuída pelo usuário. Antes de adicionar a identidade atribuída pelo sistema, você deve primeiro remover a identidade atribuída pelo usuário do recurso do aplicativo lógico.

    Seu recurso de aplicativo lógico agora pode usar a identidade atribuída pelo sistema. Essa identidade é registrada com a ID do Microsoft Entra e é representada por uma ID de objeto.

    Screenshot shows Consumption logic app, Identity page, and object ID for system-assigned identity.

    Propriedade valor Description
    ID do objeto (principal) <ID de recurso-identidade> Um GUID (Identificador Global Exclusivo) que representa a identidade atribuída pelo sistema para seu aplicativo lógico em um locatário do Microsoft Entra.

  4. Agora, siga as etapas que dão a essa identidade acesso ao recurso mais adiante neste guia.

Habilitar a identidade atribuída ao sistema em um modelo ARM

Para automatizar a criação e a implantação de recursos de aplicativos lógicos, você pode usar um modelo ARM. Para habilitar a identidade atribuída pelo sistema para seu recurso de aplicativo lógico no modelo, adicione o identity objeto e a type propriedade filho à definição de recurso do aplicativo lógico no modelo, por exemplo:

{
   "apiVersion": "2016-06-01",
   "type": "Microsoft.logic/workflows",
   "name": "[variables('logicappName')]",
   "location": "[resourceGroup().location]",
   "identity": {
      "type": "SystemAssigned"
   },
   "properties": {},
   <...>
}

Quando o Azure cria sua definição de recurso de aplicativo lógico, o identity objeto obtém estas outras propriedades:

"identity": {
   "type": "SystemAssigned",
   "principalId": "<principal-ID>",
   "tenantId": "<Azure-AD-tenant-ID>"
}
Propriedade (JSON) valor Description
principalId <ID principal> O GUID (Identificador Global Exclusivo) do objeto principal de serviço para a identidade gerenciada que representa seu aplicativo lógico no locatário do Microsoft Entra. Esse GUID às vezes aparece como um "ID de objeto" ou objectID.
tenantId <Azure-AD-tenant-ID> O GUID (Identificador Globalmente Exclusivo) que representa o locatário do Microsoft Entra onde o aplicativo lógico agora é membro. Dentro do locatário do Microsoft Entra, a entidade de serviço tem o mesmo nome que a instância do aplicativo lógico.

Criar identidade atribuída pelo usuário no portal do Azure

Antes de habilitar a identidade atribuída pelo usuário em seu recurso de aplicativo lógico de consumo ou recurso de aplicativo lógico padrão, você deve criar essa identidade como um recurso separado do Azure.

  1. Na caixa de pesquisa do portal do Azure, insira identidades gerenciadas e selecione Identidades gerenciadas.

    Screenshot shows Azure portal with selected option named Managed Identities.

  2. Na página Identidades Gerenciadas, selecione Criar.

    Screenshot shows Managed Identities page and selected option for Create.

  3. Forneça informações sobre sua identidade gerenciada e selecione Revisar + Criar, por exemplo:

    Screenshot shows page named Create User Assigned Managed Identity, with managed identity details.

    Propriedade Necessário Valor Description
    Subscrição Sim <Azure-subscrição-nome> O nome da assinatura do Azure
    Grupo de recursos Sim <Azure-recurso-grupo-nome> O nome do grupo de recursos do Azure. Crie um novo grupo ou selecione um grupo existente. Este exemplo cria um novo grupo chamado fabrikam-managed-identities-RG.
    Região Sim <Azure-region> A região do Azure onde armazenar informações sobre seu recurso. Este exemplo usa West US.
    Nome Sim <user-assigned-identity-name> O nome a ser atribuído pelo usuário. Este exemplo usa Fabrikam-user-assigned-identity.

    Depois que o Azure valida as informações, o Azure cria sua identidade gerenciada. Agora você pode adicionar a identidade atribuída pelo usuário ao recurso do aplicativo lógico.

Adicionar identidade atribuída pelo usuário ao aplicativo lógico no portal do Azure

  1. No portal do Azure, abra seu recurso de aplicativo lógico.

  2. No menu do aplicativo lógico, em Configurações, selecione Identidade.

  3. Na página Identidade, selecione Adicionar atribuído ao>usuário.

    Screenshot shows Consumption logic app and Identity page with selected option for Add.

  4. No painel Adicionar identidade gerenciada atribuída ao usuário, siga estas etapas:

    1. Na lista Assinatura, selecione sua assinatura do Azure.

    2. Na lista que tem todas as identidades gerenciadas em sua assinatura, selecione a identidade atribuída pelo usuário desejada. Para filtrar a lista, na caixa de pesquisa Identidades gerenciadas atribuídas ao usuário, digite o nome da identidade ou do grupo de recursos.

      Screenshot shows Consumption logic app and selected user-assigned identity.

    3. Quando terminar, selecione Adicionar.

      Nota

      Se você receber um erro informando que pode ter apenas uma única identidade gerenciada, seu aplicativo lógico já está associado à identidade atribuída ao sistema. Antes de adicionar a identidade atribuída pelo usuário, você precisa primeiro desabilitar a identidade atribuída pelo sistema.

    Seu aplicativo lógico agora está associado à identidade gerenciada atribuída pelo usuário.

    Screenshot shows Consumption logic app with associated user-assigned identity.

  5. Agora, siga as etapas que dão a essa identidade acesso ao recurso mais adiante neste guia.

Criar identidade atribuída pelo usuário em um modelo ARM

Para automatizar a criação e a implantação de recursos de aplicativos lógicos, você pode usar um modelo ARM. Esses modelos oferecem suporte a identidades atribuídas pelo usuário para autenticação.

Na seção do modelo, a definição de recursos do resources aplicativo lógico requer estes itens:

  • Um identity objeto com a type propriedade definida como UserAssigned

  • Um objeto filho userAssignedIdentities que especifica o recurso atribuído pelo usuário e o nome

Este exemplo mostra um recurso de aplicativo lógico de consumo e uma definição de fluxo de trabalho para uma solicitação HTTP PUT com um objeto não parametrizado identity . A resposta à solicitação PUT e à operação GET subsequente também inclui este identity objeto:

{
   "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {<template-parameters>},
   "resources": [
      {
         "apiVersion": "2016-06-01",
         "type": "Microsoft.logic/workflows",
         "name": "[variables('logicappName')]",
         "location": "[resourceGroup().location]",
         "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": {
               "/subscriptions/<Azure-subscription-ID>/resourceGroups/<Azure-resource-group-name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<user-assigned-identity-name>": {}
            }
         },
         "properties": {
            "definition": {<logic-app-workflow-definition>}
         },
         "parameters": {},
         "dependsOn": []
      },
   ],
   "outputs": {}
}

Se o modelo também incluir a definição de recurso da identidade gerenciada, você poderá parametrizar o identity objeto. O exemplo a seguir mostra como o objeto filho userAssignedIdentities faz referência a uma userAssignedIdentityName variável que você define na seção do variables modelo. Essa variável faz referência ao ID do recurso para sua identidade atribuída pelo usuário.

{
   "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
   "contentVersion": "1.0.0.0",
   "parameters": {
      "Template_LogicAppName": {
         "type": "string"
      },
      "Template_UserAssignedIdentityName": {
         "type": "securestring"
      }
   },
   "variables": {
      "logicAppName": "[parameters(`Template_LogicAppName')]",
      "userAssignedIdentityName": "[parameters('Template_UserAssignedIdentityName')]"
   },
   "resources": [
      {
         "apiVersion": "2016-06-01",
         "type": "Microsoft.logic/workflows",
         "name": "[variables('logicAppName')]",
         "location": "[resourceGroup().location]",
         "identity": {
            "type": "UserAssigned",
            "userAssignedIdentities": {
               "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities/', variables('userAssignedIdentityName'))]": {}
            }
         },
         "properties": {
            "definition": {<logic-app-workflow-definition>}
         },
         "parameters": {},
         "dependsOn": [
            "[resourceId('Microsoft.ManagedIdentity/userAssignedIdentities/', variables('userAssignedIdentityName'))]"
         ]
      },
      {
         "apiVersion": "2018-11-30",
         "type": "Microsoft.ManagedIdentity/userAssignedIdentities",
         "name": "[parameters('Template_UserAssignedIdentityName')]",
         "location": "[resourceGroup().location]",
         "properties": {}
      }
  ]
}

Dar acesso de identidade aos recursos

Antes de poder usar a identidade gerenciada do seu aplicativo lógico para autenticação, você precisa configurar o acesso para a identidade no recurso do Azure onde deseja usar a identidade. A maneira como você configura o acesso varia de acordo com o recurso que você deseja que a identidade acesse.

Nota

Quando uma identidade gerenciada tem acesso a um recurso do Azure na mesma assinatura, a identidade pode acessar somente esse recurso. No entanto, em alguns gatilhos e ações que dão suporte a identidades gerenciadas, você precisa primeiro selecionar o grupo de recursos do Azure que contém o recurso de destino. Se a identidade não tiver acesso no nível do grupo de recursos, nenhum recurso nesse grupo será listado, apesar de ter acesso ao recurso de destino.

Para lidar com esse comportamento, você também deve dar à identidade acesso ao grupo de recursos, não apenas ao recurso. Da mesma forma, se você tiver que selecionar sua assinatura antes de poder selecionar o recurso de destino, deverá conceder à identidade acesso à assinatura.

Em alguns casos, você pode precisar da identidade para obter acesso ao recurso associado. Por exemplo, suponha que você tenha uma identidade gerenciada para um aplicativo lógico que precisa de acesso para atualizar as configurações do aplicativo para esse mesmo aplicativo lógico a partir de um fluxo de trabalho. Você deve conceder a essa identidade acesso ao aplicativo lógico associado.

Por exemplo, para acessar uma conta de armazenamento de Blob do Azure com sua identidade gerenciada, você precisa configurar o acesso usando o controle de acesso baseado em função do Azure (Azure RBAC) e atribuir a função apropriada para essa identidade à conta de armazenamento. As etapas nesta seção descrevem como concluir essa tarefa usando o portal do Azure e o modelo do Azure Resource Manager (modelo ARM). Para Azure PowerShell, CLI do Azure e API REST do Azure, consulte a seguinte documentação:

Ferramenta Documentação
Azure PowerShell Adicionar atribuição de função
CLI do Azure Adicionar atribuição de função
API REST do Azure Adicionar atribuição de função

No entanto, para aceder a um cofre de chaves do Azure com a sua identidade gerida, tem de criar uma política de acesso para essa identidade no cofre de chaves e atribuir as permissões adequadas para essa identidade nesse cofre de chaves. As etapas posteriores nesta seção descrevem como concluir essa tarefa usando o portal do Azure. Para modelos do Resource Manager, PowerShell e CLI do Azure, consulte a seguinte documentação:

Ferramenta Documentação
Modelo do Azure Resource Manager (modelo do ARM) Definição de recursos da política de acesso ao Cofre da Chave
Azure PowerShell Atribuir uma política de acesso do Key Vault
CLI do Azure Atribuir uma política de acesso do Key Vault

Atribuir acesso baseado em função de identidade gerenciada no portal do Azure

Para usar uma identidade gerenciada para autenticação, alguns recursos do Azure, como contas de armazenamento do Azure, exigem que você atribua essa identidade a uma função que tenha as permissões apropriadas no recurso de destino. Outros recursos do Azure, como cofres de chaves do Azure, exigem que você crie uma política de acesso que tenha as permissões apropriadas no recurso de destino para essa identidade.

  1. No portal do Azure, abra o recurso onde você deseja usar a identidade.

  2. No menu de recursos, selecione Controle de acesso (IAM)>Adicionar>atribuição de função.

    Nota

    Se a opção Adicionar atribuição de função estiver desativada, você não terá permissões para atribuir funções. Para obter mais informações, veja Funções incorporadas do Microsoft Entra.

  3. Agora, atribua a função necessária à sua identidade gerenciada. Na guia Função, atribua uma função que dê à sua identidade o acesso necessário ao recurso atual.

    Neste exemplo, atribua a função chamada Colaborador de Dados de Blob de Armazenamento, que inclui acesso de gravação para blobs em um contêiner de Armazenamento do Azure. Para obter mais informações sobre funções específicas de contêiner de armazenamento, consulte Funções que podem acessar blobs em um contêiner de Armazenamento do Azure.

  4. Em seguida, escolha a identidade gerenciada à qual deseja atribuir a função. Em Atribuir acesso a, selecione Identidade>gerenciada Adicionar membros.

  5. Com base no tipo de identidade gerenciada, selecione ou forneça os seguintes valores:

    Tipo Instância de serviço do Azure Subscrição Membro
    Atribuído pelo sistema Aplicação Lógica <Azure-subscrição-nome> <nome-da-sua-aplicação-lógica>
    Atribuído pelo utilizador Não aplicável <Azure-subscrição-nome> <seu-usuário-atribuído-identidade-nome>

    Para obter mais informações sobre como atribuir funções, consulte Atribuir funções usando o portal do Azure.

  6. Depois de terminar, você pode usar a identidade para autenticar o acesso a gatilhos e ações que oferecem suporte a identidades gerenciadas.

Para obter mais informações gerais sobre essa tarefa, consulte Atribuir um acesso de identidade gerenciado a outro recurso usando o RBAC do Azure.

Criar política de acesso no portal do Azure

Para usar uma identidade gerenciada para autenticação, alguns recursos do Azure, como cofres de chave do Azure, exigem que você crie uma política de acesso que tenha as permissões apropriadas no recurso de destino para essa identidade. Outros recursos do Azure, como contas de armazenamento do Azure, exigem que você atribua essa identidade a uma função que tenha as permissões apropriadas no recurso de destino.

  1. No portal do Azure, abra o recurso de destino onde você deseja usar a identidade. Este exemplo usa um cofre de chaves do Azure como o recurso de destino.

  2. No menu do recurso, selecione Criar políticas>de acesso, que abre o painel Criar uma política de acesso.

    Nota

    Se o recurso não tiver a opção Políticas de acesso , tente atribuir uma atribuição de função.

    Screenshot shows Azure portal and key vault example with open pane named Access policies.

  3. Na guia Permissões, selecione as permissões necessárias que a identidade precisa para acessar o recurso de destino.

    Por exemplo, para usar a identidade com a operação de segredos de lista do conector do Azure Key Vault gerenciado, a identidade precisa de permissões de lista. Portanto, na coluna Permissões secretas, selecione Lista.

    Screenshot shows Permissions tab with selected List permissions.

  4. Quando estiver pronto, selecione Avançar. Na guia Principal, localize e selecione a identidade gerenciada, que é uma identidade atribuída pelo usuário neste exemplo.

  5. Ignore a etapa opcional Aplicativo, selecione Avançar e conclua a criação da política de acesso.

A próxima seção discute o uso de uma identidade gerenciada para autenticar o acesso a um gatilho ou ação. O exemplo continua com as etapas de uma seção anterior onde você configura o acesso para uma identidade gerenciada usando RBAC e não usa o Azure Key Vault como exemplo. No entanto, as etapas gerais para usar uma identidade gerenciada para autenticação são as mesmas.

Autenticar o acesso com identidade gerenciada

Depois de habilitar a identidade gerenciada para seu recurso de aplicativo lógico e conceder a essa identidade acesso ao recurso ou entidade de destino, você poderá usar essa identidade em gatilhos e ações que ofereçam suporte a identidades gerenciadas.

Importante

Se você tiver uma função do Azure onde deseja usar a identidade atribuída ao sistema, primeiro habilite a autenticação para o Azure Functions.

Estas etapas mostram como usar a identidade gerenciada com um gatilho ou ação por meio do portal do Azure. Para especificar a identidade gerenciada na definição JSON subjacente de um gatilho ou ação, consulte Autenticação de identidade gerenciada.

  1. No portal do Azure, abra seu recurso de aplicativo lógico.

  2. Se ainda não o fez, adicione o gatilho ou a ação que suporta identidades gerenciadas.

    Nota

    Nem todas as operações do conector oferecem suporte para adicionar um tipo de autenticação. Para obter mais informações, consulte Tipos de autenticação para gatilhos e ações que oferecem suporte à autenticação.

  3. No gatilho ou ação que você adicionou, siga estas etapas:

    • Operações de conector integradas que suportam autenticação de identidade gerenciada

      1. Na lista Adicionar novo parâmetro, adicione a propriedade Authentication se a propriedade ainda não aparecer.

        Screenshot shows Consumption workflow with built-in action and opened list named Add new parameter, with selected option for Authentication.

      2. Na lista Tipo de autenticação , selecione Identidade gerenciada.

        Screenshot shows Consumption workflow with built-in action and opened list named Authentication type, with selected option for Managed identity.

      Para obter mais informações, consulte Exemplo: autenticar gatilho ou ação interna com uma identidade gerenciada.

    • Operações de conector gerenciado que suportam autenticação de identidade gerenciada

      1. Na página de seleção de locatário, selecione Conectar com identidade gerenciada, por exemplo:

        Screenshot shows Consumption workflow with Azure Resource Manager action and selected option for Connect with managed identity.

      2. Na página seguinte, para Nome da conexão, forneça um nome a ser usado para a conexão.

      3. Para o tipo de autenticação, escolha uma das seguintes opções com base no conector gerenciado:

        • Autenticação única: esses conectores suportam apenas um tipo de autenticação. Na lista Identidade gerenciada, selecione a identidade gerenciada habilitada no momento, se ainda não estiver selecionada, e selecione Criar, por exemplo:

          Screenshot shows Consumption workflow, connection name box, and selected option for system-assigned managed identity.

        • Multiautenticação: esses conectores mostram vários tipos de autenticação, mas você ainda pode selecionar apenas um tipo. Na lista Tipo de autenticação, selecione Criação de identidade gerenciada>de aplicativos lógicos, por exemplo:

          Screenshot shows Consumption workflow, connection name box, and selected option for Logic Apps Managed Identity.

        Para obter mais informações, consulte Exemplo: autenticar gatilho ou ação de conector gerenciado com uma identidade gerenciada.

Exemplo: autenticar gatilho ou ação interna com uma identidade gerenciada

O gatilho ou ação HTTP interna pode usar a identidade atribuída ao sistema que você habilita no recurso do aplicativo lógico. Em geral, o gatilho ou ação HTTP usa as seguintes propriedades para especificar o recurso ou entidade que você deseja acessar:

Propriedade Obrigatório Description
Método Sim O método HTTP usado pela operação que você deseja executar
URI Sim A URL do ponto de extremidade para acessar o recurso ou entidade do Azure de destino. A sintaxe de URI geralmente inclui a ID do recurso ou serviço do Azure.
Cabeçalhos Não Quaisquer valores de cabeçalho que você precise ou queira incluir na solicitação de saída, como o tipo de conteúdo
Consultas Não Quaisquer parâmetros de consulta que você precise ou queira incluir na solicitação. Por exemplo, parâmetros de consulta para uma operação específica ou para a versão da API da operação que você deseja executar.
Autenticação Sim O tipo de autenticação a ser usado para autenticar o acesso ao recurso ou entidade de destino

Como um exemplo específico, suponha que você queira executar a operação de Blob de Instantâneo em um blob na conta de Armazenamento do Azure onde você configurou anteriormente o acesso para sua identidade. No entanto, o conector de Armazenamento de Blob do Azure não oferece atualmente essa operação. Em vez disso, você pode executar essa operação usando a ação HTTP ou outra operação da API REST do Serviço de Blob.

Importante

Para acessar contas de armazenamento do Azure atrás de firewalls usando o conector de Blob do Azure e identidades gerenciadas, certifique-se de que você também configurou sua conta de armazenamento com a exceção que permite o acesso por serviços confiáveis da Microsoft.

Para executar a operação Blob de Instantâneo, a ação HTTP especifica estas propriedades:

Propriedade Necessário Valor de exemplo Description
Método Sim PUT O método HTTP que a operação Snapshot Blob usa
URI Sim https://<storage-account-name>/<folder-name>/{name} A ID de recurso para um arquivo de Armazenamento de Blob do Azure no ambiente Global (público) do Azure, que usa essa sintaxe
Cabeçalhos Para o Armazenamento do Azure x-ms-blob-type = BlockBlob

x-ms-version = 2019-02-02

x-ms-date = @{formatDateTime(utcNow(),'r')}

 Os x-ms-blob-typevalores , x-ms-versione x-ms-date cabeçalho são necessários para operações de Armazenamento do Azure.

Importante: Nas solicitações de ação e gatilho HTTP de saída para o Armazenamento do Azure, o cabeçalho requer a propriedade e a versão da API para a x-ms-version operação que você deseja executar. A x-ms-date deve ser a data atual. Caso contrário, o fluxo de trabalho falhará com um 403 FORBIDDEN erro. Para obter a data atual no formato necessário, você pode usar a expressão no valor de exemplo.

Para obter mais informações, consulte a seguinte documentação:

- Cabeçalhos de solicitação - Blob de instantâneo
- Controle de versão para serviços de Armazenamento do Azure
Consultas Somente para a operação de Blob de Instantâneo comp = snapshot O nome e o valor do parâmetro de consulta para a operação.

O exemplo a seguir mostra uma ação HTTP de exemplo com todos os valores de propriedade descritos anteriormente a serem usados para a operação de Blob de Instantâneo:

Screenshot shows Azure portal, Consumption workflow, and HTTP action set up to access resources.

  1. Depois de adicionar a ação HTTP, adicione a propriedade Authentication à ação HTTP. Na lista Adicionar novo parâmetro , selecione Autenticação.

    Screenshot shows Consumption workflow with HTTP action and opened Add new parameter list with selected property named Authentication.

    Nota

    Nem todos os gatilhos e ações oferecem suporte para adicionar um tipo de autenticação. Para obter mais informações, consulte Tipos de autenticação para gatilhos e ações que oferecem suporte à autenticação.

  2. Na lista Tipo de autenticação , selecione Identidade gerenciada.

    Screenshot shows Consumption workflow, HTTP action, and Authentication property with selected option for Managed identity.

  3. Na lista de identidades gerenciadas, selecione entre as opções disponíveis com base no seu cenário.

    • Se você configurar a identidade atribuída ao sistema, selecione Identidade gerenciada atribuída ao sistema, se ainda não estiver selecionada.

      Screenshot shows Consumption workflow, HTTP action, and Managed identity property with selected option for System-assigned managed identity.

    • Se você configurar uma identidade atribuída pelo usuário, selecione essa identidade se ainda não estiver selecionada.

      Screenshot shows Consumption workflow, HTTP action, and Managed identity property with selected user-assigned identity.

    Este exemplo continua com a identidade gerenciada atribuída ao sistema.

  4. Em alguns gatilhos e ações, a propriedade Audience também aparece para você definir a ID do recurso de destino. Defina a propriedade Audience como a ID do recurso para o recurso ou serviço de destino. Caso contrário, por padrão, a propriedade Audience usa a ID do recurso, que é a ID do recurso para o Gerenciador de Recursos do https://management.azure.com/ Azure.

    Por exemplo, se você quiser autenticar o acesso a um recurso do Cofre da Chave na nuvem global do Azure, deverá definir a propriedade Audience exatamente como a seguinte ID de recurso: https://vault.azure.net. Este ID de recurso específico não tem barras à direita. Na verdade, incluir uma barra à direita pode produzir um erro ou um 400 Bad Request401 Unauthorized erro.

    Importante

    Certifique-se de que a ID do recurso de destino corresponde exatamente ao valor esperado pela ID do Microsoft Entra, incluindo quaisquer barras à direita necessárias. Por exemplo, a ID do recurso para todas as contas de Armazenamento de Blob do Azure requer uma barra à direita. No entanto, o ID do recurso para uma conta de armazenamento específica não requer uma barra à direita. Verifique as IDs de recurso para os serviços do Azure que suportam a ID do Microsoft Entra.

    Este exemplo define a propriedade Audience para que os tokens de acesso usados para autenticação sejam válidos para https://storage.azure.com/ todas as contas de armazenamento. No entanto, você também pode especificar a URL do serviço raiz, , https://<your-storage-account>.blob.core.windows.netpara uma conta de armazenamento específica.

    Screenshot shows Consumption workflow, HTTP action, and Audience

    Para obter mais informações sobre como autorizar o acesso com o Microsoft Entra ID para Armazenamento do Azure, consulte a seguinte documentação:

  5. Continue criando o fluxo de trabalho da maneira desejada.

Exemplo: autenticar o gatilho ou ação do conector gerenciado com uma identidade gerenciada

O conector gerenciado do Azure Resource Manager tem uma ação chamada Ler um recurso, que pode usar a identidade gerenciada que você habilita em seu recurso de aplicativo lógico. Este exemplo mostra como usar a identidade gerenciada atribuída ao sistema.

  1. Depois de adicionar a ação ao seu fluxo de trabalho e selecionar seu locatário do Microsoft Entra, selecione Conectar com identidade gerenciada.

    Screenshot shows Consumption workflow, Azure Resource Manager action, and selected option for Connect with managed identity.

  2. Na página nome da conexão, forneça um nome para a conexão e selecione a identidade gerenciada que você deseja usar.

    A ação do Azure Resource Manager é uma ação de autenticação única, portanto, a caixa de informações de conexão mostra uma lista de identidades gerenciadas que seleciona automaticamente a identidade gerenciada atualmente habilitada no recurso de aplicativo lógico. Se você habilitou uma identidade gerenciada atribuída ao sistema, a lista Identidade gerenciada selecionará a identidade gerenciada atribuída ao sistema. Se você tiver habilitado uma identidade gerenciada atribuída pelo usuário, a lista selecionará essa identidade.

    Se você estiver usando um gatilho ou ação de multiautenticação, como o Armazenamento de Blobs do Azure, a caixa de informações de conexão mostrará uma lista de tipos de autenticação que inclui a opção Identidade Gerenciada de Aplicativos Lógicos entre outros tipos de autenticação.

    Neste exemplo, a identidade gerenciada atribuída ao sistema é a única seleção disponível.

    Screenshot shows Consumption workflow and Azure Resource Manager action with connection name entered and selected option for System-assigned managed identity.

    Nota

    Se a identidade gerenciada não estiver habilitada quando você tentar criar a conexão, alterar a conexão ou tiver sido removida enquanto uma conexão habilitada para identidade gerenciada ainda existir, aparecerá um erro informando que você deve habilitar a identidade e conceder acesso ao recurso de destino.

  3. Quando estiver pronto, selecione Criar.

  4. Depois que o designer cria a conexão com êxito, ele pode buscar quaisquer valores dinâmicos, conteúdo ou esquema usando a autenticação de identidade gerenciada.

  5. Continue criando o fluxo de trabalho da maneira desejada.

Definição de recursos de aplicativo lógico e conexões que usam uma identidade gerenciada

Uma conexão que habilita e usa uma identidade gerenciada é um tipo de conexão especial que funciona apenas com uma identidade gerenciada. No tempo de execução, a conexão usa a identidade gerenciada habilitada no recurso do aplicativo lógico. No tempo de execução, o serviço Aplicativos Lógicos do Azure verifica se qualquer gatilho de conector gerenciado e ações no fluxo de trabalho do aplicativo lógico estão configurados para usar a identidade gerenciada e se todas as permissões necessárias estão configuradas para usar a identidade gerenciada para acessar os recursos de destino especificados pelo gatilho e pelas ações. Se for bem-sucedido, o Azure Logic Apps recupera o token do Microsoft Entra associado à identidade gerenciada e usa essa identidade para autenticar o acesso ao recurso de destino e executar a operação configurada em trigger e actions.

Em um recurso do aplicativo lógico de consumo, a configuração da conexão é salva no objeto da definição de parameters recurso do aplicativo lógico, que contém o objeto que inclui ponteiros para o ID do recurso da conexão junto com o $connections ID do recurso da identidade, se a identidade atribuída pelo usuário estiver habilitada.

Este exemplo mostra a aparência da configuração quando o aplicativo lógico habilita a identidade gerenciada atribuída ao sistema:

"parameters": {
   "$connections": {
      "value": {
         "<action-name>": {
            "connectionId": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/connections/{connection-name}",
            "connectionName": "{connection-name}",
            "connectionProperties": {
               "authentication": {
                  "type": "ManagedServiceIdentity"
               }
            },
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/{managed-connector-type}"
         }
      }
   }
}

Este exemplo mostra a aparência da configuração quando o aplicativo lógico habilita uma identidade gerenciada atribuída pelo usuário:

"parameters": {
   "$connections": {
      "value": {
         "<action-name>": {
            "connectionId": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/connections/{connection-name}",
            "connectionName": "{connection-name}",
            "connectionProperties": {
               "authentication": {
                  "type": "ManagedServiceIdentity",
                  "identity": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resourceGroupName}/providers/microsoft.managedidentity/userassignedidentities/{managed-identity-name}"
               }
            },
            "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/{managed-connector-type}"
         }
      }
   }
}

Modelo ARM para conexões de API e identidades gerenciadas

Se você usar um modelo ARM para automatizar a implantação e seu fluxo de trabalho incluir uma conexão de API, que é criada por um conector gerenciado, como o Office 365 Outlook, o Azure Key Vault e assim por diante, que usa uma identidade gerenciada, você terá uma etapa extra a seguir.

Em um modelo ARM, a definição de recurso do conector subjacente difere com base no fato de você ter um aplicativo lógico Consumo ou Padrão e se o conector mostra opções de autenticação única ou multiautenticação.

Os exemplos a seguir se aplicam aos recursos do aplicativo lógico de consumo e mostram como a definição de recurso do conector subjacente difere entre um conector de autenticação única, como a Automação do Azure, e um conector de multiautenticação, como o Armazenamento de Blobs do Azure.

Autenticação única

Este exemplo mostra a definição de recurso de conexão subjacente para uma ação de Automação do Azure em um aplicativo lógico de Consumo que usa uma identidade gerenciada onde a definição inclui os atributos:

  • A kind propriedade é definida como V1 para um aplicativo lógico de consumo.
  • A propriedade parameterValueType está definida como Alternative.
{
    "type": "Microsoft.Web/connections",
    "apiVersion": "[providers('Microsoft.Web','connections').apiVersions[0]]",
    "name": "[variables('connections_azureautomation_name')]",
    "location": "[parameters('location')]",
    "kind": "V1",
    "properties": {
        "alternativeParameterValues": {},
        "api": {
            "id": "[subscriptionResourceId('Microsoft.Web/locations/managedApis', parameters('location'), 'azureautomation')]"
        },
        "authenticatedUser": {},
        "connectionState": "Enabled",
        "customParameterValues": {},
        "displayName": "[variables('connections_azureautomation_name')]",
        "parameterValueSet": {},
        "parameterValueType": "Alternative"
    }
},

Multi-autenticação

Este exemplo mostra a definição de recurso de conexão subjacente para uma ação de Armazenamento de Blob do Azure em um aplicativo lógico de consumo que usa uma identidade gerenciada onde a definição inclui os seguintes atributos:

  • A kind propriedade é definida como V1 para um aplicativo lógico de consumo.
  • O parameterValueSet objeto inclui uma propriedade definida como e uma namevalues propriedade definida como managedIdentityAuth um objeto vazio.
{
    "type": "Microsoft.Web/connections",
    "apiVersion": "[providers('Microsoft.Web','connections').apiVersions[0]]",
    "name": "[variables('connections_azureblob_name')]",
    "location": "[parameters('location')]",
    "kind": "V1",
    "properties": {
        "alternativeParameterValues":{},
        "api": {
            "id": "[subscriptionResourceId('Microsoft.Web/locations/managedApis', parameters('location'), 'azureblob')]"
        },
        "authenticatedUser": {},
        "connectionState": "Enabled",
        "customParameterValues": {},
        "displayName": "[variables('connections_azureblob_name')]",
        "parameterValueSet":{
            "name": "managedIdentityAuth",
            "values": {}
        },
        "parameterValueType": "Alternative"
    }
}

Configurar o controle avançado sobre a autenticação de conexão de API

Quando seu fluxo de trabalho usa uma conexão de API, que é criada por um conector gerenciado, como o Office 365 Outlook, o Azure Key Vault e assim por diante, o serviço Aplicativos Lógicos do Azure se comunica com o recurso de destino, como sua conta de email, cofre de chaves e assim por diante, usando duas conexões:

Conceptual diagram showing first connection with authentication between logic app and token store plus second connection between token store and target resource.

  • A conexão #1 é configurada com autenticação para o armazenamento de token interno.

  • A conexão #2 é configurada com autenticação para o recurso de destino.

Em um recurso de aplicativo lógico de consumo, a conexão #1 é abstraída de você sem nenhuma opção de configuração. No tipo de recurso Aplicativo lógico padrão, você tem mais controle sobre seu aplicativo lógico. Por padrão, a conexão #1 é configurada automaticamente para usar a identidade atribuída pelo sistema.

No entanto, se o seu cenário exigir um controle mais fino sobre a autenticação de conexões de API, você pode, opcionalmente, alterar a autenticação da conexão #1 da identidade atribuída pelo sistema padrão para qualquer identidade atribuída pelo usuário que você adicionou ao seu aplicativo lógico. Essa autenticação se aplica a cada conexão de API, para que você possa misturar identidades atribuídas ao sistema e ao usuário em diferentes conexões com o mesmo recurso de destino.

No arquivo Standard logic app connections.json , que armazena informações sobre cada conexão de API, cada definição de conexão tem duas authentication seções, por exemplo:

"keyvault": {
   "api": {
      "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{region}/managedApis/keyvault"
   },
   "authentication": {
      "type": "ManagedServiceIdentity",
   },
   "connection": {
      "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/connections/<connection-name>"
   },
   "connectionProperties": {
      "authentication": {
         "audience": "https://vault.azure.net",
         "type": "ManagedServiceIdentity"
      }
   },
   "connectionRuntimeUrl": "<connection-runtime-URL>"
}

  • A primeira authentication seção mapeia para a conexão #1. Esta seção descreve a autenticação usada para se comunicar com o armazenamento de token interno. No passado, esta seção sempre foi definida para ManagedServiceIdentity um aplicativo que implanta no Azure e não tinha opções configuráveis.

  • A segunda authentication seção mapeia para a conexão #2. Esta seção descreve que a autenticação usada para se comunicar com o recurso de destino pode variar, com base no tipo de autenticação selecionado para essa conexão.

Por que alterar a autenticação para o armazenamento de tokens?

Em alguns cenários, talvez você queira compartilhar e usar a mesma conexão de API em vários aplicativos lógicos, mas não adicionar a identidade atribuída ao sistema para cada aplicativo lógico à política de acesso do recurso de destino.

Em outros cenários, talvez você não queira ter a identidade atribuída ao sistema totalmente configurada em seu aplicativo lógico, para que possa alterar a autenticação para uma identidade atribuída pelo usuário e desabilitar completamente a identidade atribuída pelo sistema.

Alterar a autenticação para o armazenamento de tokens

  1. No portal do Azure, abra seu recurso de aplicativo lógico padrão.

  2. No menu de recursos, em Fluxos de trabalho, selecione Conexões.

  3. No painel Conexões, selecione Exibição JSON.

    Screenshot showing the Azure portal, Standard logic app resource,

  4. No editor JSON, localize a managedApiConnections seção que contém as conexões de API em todos os fluxos de trabalho no recurso do aplicativo lógico.

  5. Encontre a conexão onde você deseja adicionar uma identidade gerenciada atribuída pelo usuário. Por exemplo, suponha que seu fluxo de trabalho tenha uma conexão do Cofre da Chave do Azure:

    "keyvault": {
   "api": {
      "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{region}/managedApis/keyvault"
   },
   "authentication": {
      "type": "ManagedServiceIdentity"
   },
   "connection": {
      "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/connections/<connection-name>"
   },
   "connectionProperties": {
      "authentication": {
         "audience": "https://vault.azure.net",
         "type": "ManagedServiceIdentity"
      }
   },
   "connectionRuntimeUrl": "<connection-runtime-URL>"
}

  6. Na definição de conexão, conclua as seguintes etapas:

    1. Encontre a primeira authentication seção. Se nenhuma identity propriedade já existir nesta authentication seção, o aplicativo lógico usará implicitamente a identidade atribuída ao sistema.

    2. Adicione uma identity propriedade usando o exemplo nesta etapa.

    3. Defina o valor da propriedade como a ID do recurso para a identidade atribuída pelo usuário.

    "keyvault": {
   "api": {
      "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{region}/managedApis/keyvault"
   },
   "authentication": {
      "type": "ManagedServiceIdentity",
      // Add "identity" property here
      "identity": "/subscriptions/{Azure-subscription-ID}/resourcegroups/{resource-group-name}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identity-resource-ID}" 
   },
   "connection": {
      "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{resource-group-name}/providers/Microsoft.Web/connections/<connection-name>"
   },
   "connectionProperties": {
      "authentication": {
         "audience": "https://vault.azure.net",
         "type": "ManagedServiceIdentity"
      }
   },
   "connectionRuntimeUrl": "<connection-runtime-URL>"
}

  7. No portal do Azure, vá para o recurso de destino e dê acesso à identidade gerenciada atribuída pelo usuário, com base nas necessidades do recurso de destino.

    Por exemplo, para o Cofre de Chaves do Azure, adicione a identidade às políticas de acesso do cofre de chaves. Para o Armazenamento de Blobs do Azure, atribua a função necessária para a identidade à conta de armazenamento.

Desativar identidade gerenciada

Para parar de usar a identidade gerenciada para autenticação, primeiro remova o acesso da identidade ao recurso de destino. Em seguida, no recurso do aplicativo lógico, desative a identidade atribuída pelo sistema ou remova a identidade atribuída pelo usuário.

Ao desabilitar a identidade gerenciada em seu recurso de aplicativo lógico, você remove o recurso dessa identidade para solicitar acesso aos recursos do Azure onde a identidade tinha acesso.

Nota

Se você desabilitar a identidade atribuída ao sistema, toda e qualquer conexão usada pelos fluxos de trabalho no fluxo de trabalho desse aplicativo lógico não funcionará em tempo de execução, mesmo que você habilite imediatamente a identidade novamente. Esse comportamento acontece porque desabilitar a identidade exclui a ID do objeto. Cada vez que você habilita a identidade, o Azure gera a identidade com uma ID de objeto diferente e exclusiva. Para resolver esse problema, você precisa recriar as conexões para que eles usem o ID de objeto atual para a identidade atribuída ao sistema atual.

Tente evitar ao máximo desativar a identidade atribuída ao sistema. Se você quiser remover o acesso da identidade aos recursos do Azure, remova a atribuição de função da identidade do recurso de destino. Se você excluir seu recurso de aplicativo lógico, o Azure removerá automaticamente a identidade gerenciada da ID do Microsoft Entra.

As etapas nesta seção abrangem o uso do portal do Azure e do modelo do Azure Resource Manager (modelo ARM). Para Azure PowerShell, CLI do Azure e API REST do Azure, consulte a seguinte documentação:

Ferramenta Documentação
Azure PowerShell 1. Remova a atribuição de função.
2. Exclua a identidade atribuída pelo usuário.
CLI do Azure 1. Remova a atribuição de função.
2. Exclua a identidade atribuída pelo usuário.
API REST do Azure 1. Remova a atribuição de função.
2. Exclua a identidade atribuída pelo usuário.

Desabilitar identidade gerenciada no portal do Azure

Para remover o acesso à identidade gerenciada, remova a atribuição de função da identidade do recurso de destino e desabilite a identidade gerenciada.

Remover atribuição de função

As etapas a seguir removem o acesso ao recurso de destino da identidade gerenciada:

  1. No portal do Azure, vá para o recurso do Azure de destino onde você deseja remover o acesso para a identidade gerenciada.

  2. No menu do recurso de destino, selecione Controle de acesso (IAM). Na barra de ferramentas, selecione Atribuições de função.

  3. Na lista de funções, selecione as identidades gerenciadas que você deseja remover. Na barra de ferramentas, selecione Remover.

    Gorjeta

    Se a opção Remover estiver desativada, é provável que não tenha permissões. Para obter mais informações sobre as permissões que permitem gerenciar funções para recursos, consulte Permissões de função de administrador no Microsoft Entra ID.

Desabilitar identidade gerenciada no recurso de aplicativo lógico

  1. No portal do Azure, abra seu recurso de aplicativo lógico.

  2. No menu de navegação da aplicação lógica, em Definições, selecione Identidade e, em seguida, siga os passos para a sua identidade:

    • Selecione Sistema atribuído ao>>salvar. Quando o Azure solicitar a confirmação, selecione Sim.

    • Selecione Usuário atribuído e a identidade gerenciada e, em seguida, selecione Remover. Quando o Azure solicitar a confirmação, selecione Sim.

Desabilitar identidade gerenciada em um modelo ARM

Se você criou a identidade gerenciada do aplicativo lógico usando um modelo ARM, defina a identity propriedade filho do type objeto como None.

"identity": {
   "type": "None"
}

Próximos passos