Receber e responder a chamadas HTTPS de entrada para fluxos de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)

Este guia de instruções mostra como criar um fluxo de trabalho de aplicativo lógico que pode receber e manipular uma solicitação HTTPS de entrada ou chamada de outro serviço usando o gatilho interno Solicitação. Quando seu fluxo de trabalho usa esse gatilho, você pode responder à solicitação HTTPS usando a ação interna Resposta.

Observação

A ação Resposta funciona somente quando você usa o gatilho Solicitação.

Por exemplo, esta lista descreve algumas tarefas que seu fluxo de trabalho pode executar quando você usa a ação Gatilho de solicitação e Resposta:

  • Receber e responder a uma solicitação HTTPS para dados em um banco de dado local.

  • Receba e responda a uma solicitação HTTPS enviada de outro fluxo de trabalho de aplicativo lógico.

  • Disparar uma execução de fluxo de trabalho quando ocorrer um evento de webhook externo.

Para executar o fluxo de trabalho enviando uma solicitação de saída ou enviada, use o gatilho interno HTTP ou a ação interna HTTP.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Se você não tem uma assinatura, inscreva-se em uma conta gratuita do Azure.

  • O fluxo de trabalho do aplicativo lógico no qual você deseja receber a solicitação HTTPS de entrada. Para iniciar seu fluxo de trabalho com um gatilho de Solicitação, você precisará começar com um fluxo de trabalho em branco. Para usar a ação de Resposta, seu fluxo de trabalho deve começar com o gatilho de Solicitação.

Adicionar um gatilho de Solicitação

O gatilho Request cria um ponto de extremidade chamável manualmente que manipula apenas solicitações de entrada por HTTPS. Quando o chamador envia uma solicitação para esse ponto de extremidade, o gatilho Solicitação é acionado e executa o fluxo de trabalho. Para saber sobre como chamar este gatilho, revise o Chamar, disparar ou aninhar fluxos de trabalho com pontos de extremidade HTTPS em Aplicativos Lógicos do Azure.

  1. No portal do Azure, abra o fluxo de trabalho em branco do aplicativo lógico de Consumo no designer.

  2. No designer, siga estas etapas gerais para localizar e adicionar o gatilho interno de solicitação chamado Quando uma solicitação HTTP é recebida.

  3. Depois que a caixa de informações do gatilho for exibida, forneça as seguintes informações, conforme necessário:

    Nome da propriedade Nome da propriedade JSON Obrigatório Descrição
    HTTP POST URL {none} Sim O URL do ponto de extremidade gerada depois que você salva o fluxo de trabalho e é usada para enviar uma solicitação que dispara seu fluxo de trabalho.
    Esquema JSON do corpo da solicitação schema Não O esquema JSON que descreve as propriedades e os valores no corpo da solicitação de entrada. O designer usa esse esquema para gerar tokens para as propriedades na solicitação. Dessa forma, o fluxo de trabalho pode analisar, consumir e passar as saídas do gatilho de Solicitação para o fluxo de trabalho.

    Se você não tiver um esquema JSON, poderá gerar o esquema a partir de um payload de amostra com o recurso Usar payload de amostra para gerar o esquema.

    O exemplo a seguir mostra um esquema JSON de exemplo:

    Screenshot showing Consumption workflow and Request trigger with example JSON schema.

    O exemplo a seguir mostra o esquema JSON de exemplo completo:

    {
   "type": "object",
   "properties": {
      "account": {
         "type": "object",
         "properties": {
            "name": {
               "type": "string"
            },
            "ID": {
               "type": "string"
            },
            "address": {
               "type": "object",
               "properties": {
                  "number": {
                     "type": "string"
                  },
                  "street": {
                     "type": "string"
                  },
                  "city": {
                     "type": "string"
                  },
                  "state": {
                     "type": "string"
                  },
                  "country": {
                     "type": "string"
                  },
                  "postalCode": {
                     "type": "string"
                  }
               }
            }
         }
      }
   }
}

    Quando você insere um esquema JSON, o designer mostra um lembrete para incluir o cabeçalho Tipo de Conteúdo em sua solicitação e definir esse valor de cabeçalho como aplicativo/json. Para saber mais, veja Lidar com tipos de conteúdo.

    Screenshot showing Consumption workflow, Request trigger, and reminder to include

    O exemplo a seguir mostra como o cabeçalho Tipo de Conteúdo aparece no formato JSON:

    {
   "Content-Type": "application/json"
}

    Para gerar um esquema JSON baseado no payload esperado (dados), você pode usar uma ferramenta como JSONSchema.net, ou pode seguir estas etapas:

    1. No gatilho de Solicitação, selecione Usar o conteúdo de amostra para gerar o esquema.

      Screenshot showing Consumption workflow, Request trigger, and

    2. Insira o payload de exemplo e selecione Concluído.

      Screenshot showing Consumption workflow, Request trigger, and sample payload entered to generate schema.

      O exemplo a seguir mostra o payload de amostra:

      {
   "account": {
      "name": "Contoso",
      "ID": "12345",
      "address": {
         "number": "1234",
         "street": "Anywhere Street",
         "city": "AnyTown",
         "state": "AnyState",
         "country": "USA",
         "postalCode": "11111"
      }
   }
}

  4. Para verificar se a chamada de entrada tem um corpo de solicitação correspondente ao esquema especificado, siga estas etapas:

    1. Para impor a mensagem de entrada para ter exatamente os mesmos campos que seu esquema descreve, em seu esquema, adicione a propriedade required e especifique os campos obrigatórios. Adicione a propriedade addtionalProperties e defina o valor para false.

      Por exemplo, o esquema a seguir especifica que a mensagem de entrada deve ter o campo msg e não qualquer outro campo:

      {
   "properties": {
     "msg": {
        "type": "string"
     }
   },
   "type": "object",
   "required": ["msg"],
   "additionalProperties": false
}

    2. Na barra de legenda do gatilho de solicitação, selecione o botão de reticências (...).

    3. Nas configurações do gatilho, ative a validação de esquemae selecione Concluído.

      Se o corpo da solicitação da chamada de entrada não corresponder ao seu esquema, o gatilho retornará um erro Solicitação inválida de HTTP 400.

  5. Para adicionar outras propriedades ou parâmetros ao gatilho, abra a lista Adicionar novo parâmetro e selecione os parâmetros que você deseja adicionar.

    Nome da propriedade Nome da propriedade JSON Obrigatório Descrição
    Método method Não O método que as solicitações de entrada devem usar para chamar seu aplicativo lógico
    Caminho relativo relativePath Não O caminho relativo para o parâmetro que a URL do seu ponto de extremidade pode aceitar

    O exemplo a seguir adiciona a propriedade Método:

    Screenshot showing Consumption workflow, Request trigger, and adding the

    A propriedade Método aparece no gatilho para que você possa selecionar um método na lista.

    Screenshot showing Consumption workflow, Request trigger, and the

  6. Quando estiver pronto, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

    Esta etapa gera o URL que é possível usar depois para enviar uma solicitação que dispara o fluxo de trabalho.

  7. Para copiar o URL gerado, selecione o ícone de cópia ao lado do URL.

    Screenshot showing Consumption workflow, Request trigger, and URL copy button selected.

    Observação

    Se quiser incluir o código hash ou símbolo de libra (#) no URI ao fazer uma chamada para o gatilho de solicitação, use esta versão codificada: %25%23

Agora, continue criando seu fluxo de trabalho adicionando outra ação como a próxima etapa. Por exemplo, você pode responder à solicitação adicionando uma ação de Resposta, que pode ser usada para retornar uma resposta personalizada e é descrita posteriormente neste artigo.

Observação

Seu fluxo de trabalho mantém uma solicitação de entrada aberta apenas por tempo limitado. Supondo que seu fluxo de trabalho também inclua uma ação de Resposta, se o fluxo de trabalho não retornar uma resposta ao chamador após esse período expirar, seu fluxo de trabalho retornará o status 504 GATEWAY TIMEOUT para o chamador. Se o fluxo de trabalho não incluir uma ação de Resposta, o fluxo de trabalho retornará imediatamente o status 202 ACCEPTED para o chamador.

Para obter informações sobre segurança, autorização e criptografia para chamadas de entrada para seu fluxo de trabalho, como TLS (Transport Layer Security), anteriormente conhecido como SSL (Secure Sockets Layer), Autenticação Aberta de ID do Microsoft Entra (Microsoft Entra ID OAuth), expondo seu recurso de aplicativo lógico com o Gerenciamento de API do Azure ou restringindo os endereços IP que originam chamadas de entrada, consulte Acesso seguro e dados - Acesso para chamadas de entrada a gatilhos baseados em solicitação.

Saídas do gatilho

A tabela a seguir lista as saídas do gatilho de solicitação:

Nome da propriedade JSON Tipo de dados Descrição
headers Objeto Um objeto JSON que descreve os cabeçalhos da solicitação
Corpo Objeto Um objeto JSON que descreve o conteúdo do corpo da solicitação

Adicionar uma ação de resposta

Ao usar o gatilho de solicitação para receber solicitações de entrada, é possível modelar a resposta e retornar os resultados do conteúdo ao chamador usando a ação interna de Resposta, que funciona apenas com o gatilho de Solicitação. Essa combinação com o gatilho de solicitação e a ação de resposta cria o padrão de solicitação-resposta. Com exceção dos loops Foreach e Until e branches paralelos, é possível adicionar a ação de resposta em qualquer lugar no seu fluxo de trabalho.

Importante

  • Se sua ação de resposta incluir esses cabeçalhos a seguir, os Aplicativos Lógicos do Azure removerão automaticamente esses cabeçalhos da mensagem de resposta gerada sem mostrar nenhum aviso ou erro. Os Aplicativos Lógicos do Azure não incluirão esses cabeçalhos, embora o serviço não impeça você de salvar fluxos de trabalho que têm uma ação de resposta com esses cabeçalhos.

    • Allow
    • Cabeçalhos de Content-*, com exceção de Content-Disposition, Content-Encoding e Content-Type ao usar operações POST e PUT, mas não são incluídos para operações GET
    • Cookie
    • Expires
    • Last-Modified
    • Set-Cookie
    • Transfer-Encoding

  • Se você tiver uma ou mais ações de resposta em um fluxo de trabalho complexo com branches, verifique se a o fluxo de trabalho processa, pelo menos, uma ação de resposta durante o runtime. Caso contrário, se todas as ações de resposta forem ignoradas, o chamador receberá o erro 502 Gateway Inválido, mesmo que o fluxo de trabalho seja concluído com êxito.

  • Em um fluxo de trabalho sem estado do aplicativo lógico Standard, a ação Resposta deve aparecer por último no fluxo de trabalho. Se a ação aparecer em qualquer outro lugar, os Aplicativos Lógicos do Azure não executarão a ação até que todas as outras ações terminem de ser executadas.

  1. No designer de fluxo de trabalho, siga estas etapas gerais para localizar e adicionar a ação interna de Resposta chamada Resposta.

    Para simplificar, os exemplos a seguir mostram um gatilho de solicitação recolhido.

  2. Na caixa de informações da ação, adicione os valores necessários para a mensagem de resposta.

    Nome da propriedade Nome da propriedade JSON Obrigatório Descrição
    Código de status statusCode Sim O código de status a ser retornado na resposta
    Cabeçalhos headers Não Um objeto JSON que descreve um ou mais cabeçalhos a serem incluídos na resposta
    Corpo body Não O corpo da resposta

    Quando você seleciona dentro de qualquer campo de texto, a lista de conteúdo dinâmico é aberta automaticamente. Em seguida, você pode selecionar tokens que representam quaisquer saídas disponíveis de etapas anteriores no fluxo de trabalho. As propriedades do esquema especificado também aparecem nessa lista de conteúdo dinâmico. Você pode selecionar essas propriedades para usar em seu fluxo de trabalho.

    Por exemplo, no campo Cabeçalhos , inclua Content-Type como o nome da chave e defina o valor da chave como application/json , conforme mencionado anteriormente neste artigo. Para a caixa Corpo, você pode selecionar a saída do corpo do gatilho na lista de conteúdo dinâmico.

    Screenshot showing Azure portal, Consumption workflow, and Response action information.

    Para exibir os cabeçalhos no formato JSON, selecione Alternar para exibição de texto.

    Screenshot showing Azure portal, Consumption workflow, and Response action headers in

  3. Para adicionar mais propriedades para a ação, como um esquema JSON para o corpo da resposta, na lista Adicionar novo parâmetro , selecione os parâmetros que deseja adicionar.

  4. Quando terminar, salve o fluxo de trabalho. Selecione Salvar na barra de ferramentas do designer.

Testar seu fluxo de trabalho

Para testar seu fluxo de trabalho, envie uma solicitação HTTP para o URL gerado. Por exemplo, você pode usar uma ferramenta como Postman para enviar a solicitação HTTP. Para obter mais informações sobre a definição JSON subjacente do gatilho e como chamar esse gatilho, consulte os tópicos tipo de gatilho de solicitação e Chamar, disparar ou aninhar fluxos de trabalho com pontos de extremidade HTTPS nos Aplicativos Lógicos do Azure.

Segurança e autenticação

Em um fluxo de trabalho do aplicativo lógico Standard que começa com o gatilho de solicitação (mas não um gatilho de webhook), você pode usar o provisionamento Azure Functions para autenticar chamadas de entrada enviadas para o ponto de extremidade criado por esse gatilho usando uma identidade gerenciada. Essa provisão também é conhecida como "Autenticação Fácil". Para obter mais informações, examine os fluxos de trabalho do Gatilho em aplicativos lógicos Standard com o Easy Auth.

Para obter mais informações sobre segurança, autorização e criptografia para chamadas de entrada para seu fluxo de trabalho de aplicativo lógico, como TLS (Transport Layer Security), anteriormente conhecido como SSL (Secure Sockets Layer), Microsoft Entra ID Open Authentication (Microsoft Entra ID OAuth), expondo seu aplicativo lógico com o Gerenciamento de API do Azure ou restringindo os endereços IP que originam chamadas de entrada, consulte Acesso seguro e dados - Acesso para chamadas de entrada a gatilhos baseados em solicitação.

Próximas etapas