Conectores personalizados
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.
Ciclo de vida
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):
- OAuth 2.0 genérico
- OAuth 2.0 para serviços específicos, incluindo o Microsoft Entra ID, Dropbox, GitHub e SalesForce
- Autenticação básica
- Chave API
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". - Quando os conectores personalizados forem atualizados para utilizarem o URI de redirecionamento por conector, através da definição no separador Segurança ou através da ferramenta CLI, deverá remover o URI de redirecionamento global das suas aplicações 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 que não tenha sido atualizado para usar um URI de redirecionamento por conector deixa de funcionar para novas conexões e mostra uma mensagem de erro ao utilizador.
- Para descobrir que conectores personalizados precisam de uma atualização para migrar por URL de redirecionamento de conector, pode criar um fluxo simples que usa a ação Obter Conectores Personalizados como Admin do conector do Power Apps para Admin e analise o 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:
Uma definição de OpenAPI (anteriormente conhecido como ficheiro Swagger)
Uma Coleção do Postman
Começar do zero através do portal do conector personalizado (apenas o Power Automate e o Power Apps)
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 no Power Automate estão disponíveis no Power Apps. Da mesma forma, os conectores criados no Power Apps estão disponíveis no Power Automate. Isto não é verdade 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:
- Utilizar um conector personalizado a partir de um fluxo
- Utilizar um conector personalizado a partir de uma aplicação
- Utilizar um conector personalizado a partir de uma aplicação lógica
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.
Para obter mais informações, veja Partilhar conectores personalizados na 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.
Tutorial
O tutorial utiliza a API Análise de Texto dos Serviços Cognitivos. A Microsoft já fornece um conector para esta API. É um bom exemplo para ensinar o ciclo de vida do conector personalizado e como os conectores personalizados podem suportar cenários exclusivos.
Cenário
O conector que cria expõe a operação do Sentimento de Análise de Texto, a qual devolve a classificação de sentimento (0,000 a 1,000) da entrada de texto.
Pré-requisitos
Uma das seguintes subscrições:
- Uma subscrição do Azure (Logic Apps)
- Power Automate
- Power Apps
Noções básicas sobre como criar fluxos do Logic Apps, Power Automate ou Power Apps.
Chave de API para a API de Análise de Texto dos Serviços Cognitivos.
Obter uma chave de API
A API Análise de Texto utiliza uma chave de API para autenticar utilizadores. Quando um utilizador cria uma ligação à API através de um conector personalizado, o utilizador especifica o valor desta chave. Para obter uma chave de API:
Peça uma chave de API para experimentar a API. Isto não requer uma subscrição do Azure.
Adicione a API de Análise de Texto à sua subscrição do Azure. Quando tiver o recurso da API na sua subscrição, obtenha a chave de API a partir da secção Chaves:
Iniciar o tutorial
Se estiver a utilizar o Logic Apps, consulte:
Se estiver a utilizar o Power Automate ou o Power Apps, consulte:
Orientação avançada
Os tutoriais e o vídeo nesta secção dão-lhe as informações necessárias para tirar partido de conectores do Power Platform como parte das suas implementações.
Tutoriais
Os seguintes tutoriais fornecem mais detalhes para os cenários de conector personalizado:
- Expandir uma definição de OpenAPI
- Criar um conector personalizado a partir de um conector personalizado
- Autenticar com o Microsoft Entra ID
- Criar um conector para uma API Web
- Utilizar um webhook como acionador
- Criar um conector da API SOAP do Logic Apps
Vídeo
O seguinte vídeo de 45 minutos mostra como os conectores do Power Platform funcionam. Também demonstra como criar conectores personalizados simples e avançados.
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 é utilizado: As limitações são explicadas em Escrever código num conector personalizado.
Os conectores personalizados que foram criados antes de o ambiente ter sido associado a uma Rede Virtual têm de ser guardados 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.