Descrição geral dos conectores personalizados
Embora os Aplicativos LógicosMicrosoft Power Automate do Azure ofereçam Microsoft Power Apps mais de 1.000 conectores para se conectar à Microsoft e a serviços verificados, talvez você queira se comunicar com serviços que não estão 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úblico (visível na internet pública), como Spotify, Slack, Rackspace ou uma API que você gerencia.
- 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 APIs privadas, a Microsoft oferece conectividade de dados local por meio de um gateway de dados local.
2. Proteger a sua API
Use um destes métodos de autenticação padrão para suas APIs e conectores (Microsoft Entra ID é recomendado):
- Genéricos OAuth 2.0
- OAuth 2.0 para serviços específicos, incluindo Microsoft Entra ID, Dropbox, GitHub e SalesForce
- Autenticação básica
- Chave da 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 Microsoft Entra ID para conectores personalizados, consulte Proteger sua API e conector com Microsoft Entra ID.
2.1. OAuth 2.0
Os conectores personalizados recém-criados que usam OAuth 2.0 para autenticar automaticamente têm um URI de redirecionamento por conector. Os conectores 2.0 existentes OAuth devem ser atualizados para usar um URI de redirecionamento por conector antes de 17 de fevereiro de 2024.
- Se você criou seus conectores personalizados com a interface da Web, edite seus conectores personalizados, vá para a guia Segurança e marque a caixa,Atualizar para URL de redirecionamento exclusivo e salve para habilitar o URI de redirecionamento por conector.
- Se você criou seus conectores personalizados com multi-auth usando a ferramenta de interface de linha de comando (CLI), você precisa atualizar 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 de seus OAuth aplicativos 2.0. Você deve adicionar o URL de redirecionamento exclusivo recém-gerado aos seus OAuth aplicativos 2.0.
- Aplicaremos esta atualização para conectores personalizados 2.0 existentes OAuth 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 usuário.
- 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, ele aplica uma condição de filtro na propriedade do parâmetro de conexão para filtrar o conector personalizado não-Oauth, seguido por outro filtro para selecionar apenas conectores que não usam a URL de redirecionamento exclusiva 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. Você pode importar esse fluxo para seu ambiente importando 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 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 em Aplicativos Lógicos. 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:
- Usar um conector personalizado a partir de um fluxo
- Usar um conector personalizado de um aplicativo
- Usar um conector personalizado de um aplicativo lógico
Sugestão
Se você atualizar (remover, adicionar ou alterar) um campo na API, execute estas etapas:
- Republique o conector para que ele examine o Swagger atualizado para a API.
- Remova qualquer conexão / fonte de dados em qualquer aplicativo que usou esse conector.
- Adicione novamente a conexão/fonte de dados desse 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 obter mais informações, consulte Enviar seus conectores para certificação Microsoft.
Suporte de Rede Virtual
Quando o conector é usado em um Power Platform ambiente vinculado 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.
Não há suporte para gatilhos que retornam o cabeçalho de local que não chamam de volta para o conector personalizado.
Enviar comentários
Apreciamos os comentários sobre problemas com a nossa plataforma de conectores ou novas ideias de funcionalidades. Para fornecer comentários, vá para Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.