Partilhar via

Descrição geral dos conectores personalizados

  • Artigo

Embora o Azure Logic Apps, o Microsoft Power Automate e o Microsoft Power Apps ofereçam mais de 1000 conectores que lhe permitem ligar-se a serviços Microsoft e a serviços verificados, poderá querer comunicar com serviços que não estejam disponíveis como conectores pré-criados. Os conectores personalizados abordam este cenário na medida em que lhe permitem criar (e até partilhar) um conector com acionadores e ações próprios.

Captura de tela mostrando como conectores personalizados fazem a ponte entre a API de Análise de Texto e os aplicativos.

Ciclo de vida

Captura de tela do ciclo de vida dos conectores personalizados em cinco estágios.

1. Compilar a sua API

Um conector personalizado é um wrapper à volta de uma API REST que permite ao Logic Apps, ao Power Automate ou ao Power Apps comunicar com essa API REST ou SOAP. Estas APIs podem ser:

  • Públicas (visíveis na Internet pública) como o Spotify, Slack, Rackspace ou uma API que gira.
  • Privadas (visível apenas para a sua rede).

O Logic Apps também suporta APIs SOAP.

Para as APIs públicas que planeia criar e gerir, considere utilizar um destes produtos do Microsoft Azure:

Para as APIs privadas, a Microsoft oferece conectividade de dados no local através de um gateway de dados no local.

2. Proteger a sua API

Utilize um destes métodos de autenticação padrão para as suas APIs e conectores (Microsoft Entra ID é recomendado):

Pode configurar a autenticação do Microsoft Entra ID para a sua API no portal do Azure para que não tenha de implementar a autenticação. Ou pode exigir e impor a autenticação no código da sua API. Para obter mais informações sobre o Microsoft Entra ID relativamente a conectores personalizados, consulte Proteger a API e o conector com o Microsoft Entra ID.

2.1. OAuth 2.0

Conectores personalizados recém-criados que usam o OAuth 2.0 para autenticação automática têm um URI de redirecionamento por conector. Os conectores OAuth 2.0 existentes devem ser atualizados para usar um URI de redirecionamento por conector antes de 17 de fevereiro de 2024.

  • Se criou os seus conectores personalizados com a interface da Web, edite-os, vá para o separador Segurança e marque a caixa Atualizar para URL de redirecionamento exclusivo e guarde para ativar o URI de redirecionamento por conector.
  • Se criou os seus conectores personalizados com autenticação múltipla usando a ferramenta de interface de linha de comandos (CLI), será necessário atualizar o seu conector usando a ferramenta CLI para definir "redirectMode": "GlobalPerConnector".
  • Depois que os conectores personalizados forem atualizados para usar o URI de redirecionamento por conector por meio da configuração na guia Segurança ou da ferramenta CLI, remova o URI de redirecionamento global dos aplicativos OAuth 2.0. Deve adicionar o URL de redirecionamento exclusivo recentemente gerado às suas aplicações OAuth 2.0.
  • Aplicaremos esta atualização para conectores personalizados OAuth 2.0 existentes a partir de 17 de fevereiro de 2024. Qualquer conector personalizado não atualizado para usar um URI de redirecionamento por conector para de funcionar para novas conexões e mostra uma mensagem de erro para o utente.
  • Para descobrir quais conectores personalizados precisam de uma atualização para migrar para a URL de redirecionamento por conector, você pode criar um fluxo que use a ação Obter conectores personalizados como administrador do Power Apps conector Admin e analisar seu resultado. O fluxo anexado mais à frente neste artigo obtém todos os conectores personalizados que usam o mesmo. Em seguida, aplica uma condição de filtro na propriedade do parâmetro de ligação para deixar de fora conectores personalizados não Oauth, seguido por outro filtro para selecionar apenas conectores que não usam o URL de redirecionamento exclusivo por conector. Por fim, coloca os conectores personalizados selecionados numa variável de matriz inicializada no início do fluxo e gera uma tabela HTML que mostra o nome e o criador desses conectores. Pode importar este fluxo para o seu ambiente ao importar esta solução. Pode expandir ainda mais o fluxo para enviar a tabela HTML como um e-mail para si mesmo. Ou pode expandi-lo para enviar e-mails diretamente aos criadores do conector e fornecer-lhes os nomes do conector que precisa de ser atualizado.

3. Descrever a API e definir o conector personalizado

Quando tiver uma API com acesso autenticado, o passo seguinte consiste em descrever a API para o Logic Apps, o Power Automate ou o Power Apps poderem comunicar com a sua API. São suportadas as seguintes abordagens:

As definições de OpenAPI e as coleções do Postman utilizam formatos diferentes, mas ambos são documentos legíveis por máquina e de linguagem desconhecida que descrevem a sua API. Pode gerar estes documentos a partir de várias ferramentas, com base na linguagem e plataforma que a API utiliza. Em fundo, as Logic Apps, o Power Automate e o Power Apps utilizam OpenAPI para definir conectores.

4. Utilizar o conector numa aplicação do Logic App, do Power Automate ou do Power Apps

Os conectores personalizados são utilizados da mesma forma que os conectores pré-criados. Tem de criar uma ligação à sua API para poder utilizar essa ligação para chamar quaisquer operações que expõe no seu conector personalizado.

Os conectores criados em Power Automate estão disponíveis em Power Apps, e os conectores criados em Power Apps estão disponíveis em Power Automate. Essa disponibilidade não é verdadeira para conectores criados no Logic Apps. No entanto, pode reutilizar a definição de OpenAPI ou a coleção do Postman para recriar o conector em qualquer um destes serviços. Para obter mais informações, consulte o tutorial adequado:

Dica

Se você atualizar (remover, adicionar ou alterar) um campo na API, execute estas etapas:

  1. Republique o conector para que ele examine o Swagger atualizado para a API.
  2. Remova qualquer conexão / origem de dados em qualquer aplicativo que usou esse conector.
  3. Adicione novamente a conexão / origem de dados para esse conector de volta aos aplicativos.

5. Partilhar o conector

Pode partilhar o seu conector com utilizadores na sua organização da mesma forma que partilha recursos no Logic Apps, Power Automate ou Power Apps. A partilha é opcional, mas pode ter cenários nos quais pretende partilhar os conectores com outros utilizadores.

Saiba mais em Compartilhar conectores personalizados em sua organização.

6. Certificar o conector

Se quiser partilhar o seu conector com todos os utilizadores do Logic Apps, do Power Automate e do Power Apps, pode submetê-lo à Microsoft para certificação. A Microsoft analisa o conector, verifica a conformidade técnica e de conteúdo e valida a funcionalidade.

Para mais informações, veja Submeter os seus conectores para certificação da Microsoft.

Suporte de Rede Virtual

Quando o conector é utilizado num ambiente do Power Platform ligado a uma Rede Virtual, aplicam-se limitações:

  • Quando o código personalizado é usado, as limitações são explicadas em Escrever código em um conector personalizado.

  • Os conectores personalizados criados antes de o ambiente ser associado a uma Rede Virtual precisam ser salvos novamente.

Enviar comentários

Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para enviar comentários, aceda a Submeter problemas ou obter ajuda com conectores e selecione o tipo de comentários.