Visão geral de conectores personalizados
Embora Azure Logic Apps, Microsoft Power Automate e Microsoft Power Apps ofereçam 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 lidam com esse cenário permitindo a criação (e até mesmo o compartilhamento) de um conector com seus próprios gatilhos e ações.
Ciclo de vida
1. Crie sua API
Um conector personalizado é um wrapper em torno de uma API REST que permite que os Aplicativos Lógicos, o Power Automate ou o Power Apps se comuniquem com a API REST ou a API SOAP. Essas APIs podem ser:
- Público (visível na internet pública), como Spotify, Slack, Rackspace ou uma API que você gerencia.
- Privado (visível apenas para sua rede).
Os Aplicativos Lógicos também oferecem suporte às APIs SOAP.
Para APIs públicas que você planeja criar e gerenciar, considere usar 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. Proteja sua API
Use um destes métodos de autenticação padrão para suas APIs e conectores (Microsoft Entra ID é recomendado):
- Genérico OAuth 2.0
- OAuth 2.0 para serviços específicos, incluindo Microsoft Entra ID, Dropbox, GitHub e SalesForce
- Autenticação básica
- Chave API
Você pode configurar a autenticação do Microsoft Entra ID para sua API no portal do Azure para que você não precise implementar a autenticação. Ou você pode exigir e impor autenticação no código da API. Para obter mais informações sobre Microsoft Entra ID para conectores personalizados, consulte Proteja sua API e conector com Microsoft Entra ID.
2.1. OAuth 2.0
Os 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 2.0 existentes devem ser atualizados para usar um URI de redirecionamento por conector antes de 17 de fevereiro de 2024. OAuth
- Se você criou seus conectores personalizados com a interface da web, edite-os, 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-autenticação 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, seja por meio da configuração na guia Segurança ou da ferramenta CLI, remova o URI de redirecionamento global dos seus aplicativos OAuth 2.0. Você deve adicionar o URL de redirecionamento exclusivo recém-gerado aos seus aplicativos OAuth 2.0.
- Aplicaremos essa 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 ao usuário.
- Para descobrir quais conectores personalizados precisam de uma atualização para migrar para cada URL de redirecionamento do conector, você pode criar um fluxo que use a ação Obter conectores personalizados como administrador do conector Power Apps para administrador e analisar seu resultado. O fluxo anexado posteriormente neste artigo busca todos os conectores personalizados usando 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 o URL de redirecionamento exclusivo por conector. Por fim, ele coloca os conectores personalizados selecionados em uma variável de matriz inicializada no início do fluxo e gera uma tabela HTML mostrando o nome e o criador desses conectores. Você pode importar esse fluxo para seu ambiente importando esta solução. Você pode estender ainda mais o fluxo para enviar a tabela HTML como um email para você mesmo. ou você pode estendê-lo para enviar emails diretamente aos criadores do conector e fornecer a eles os nomes dos conectores que precisam ser atualizados.
3. Descreva a API e defina o conector personalizado
Depois de ter uma API com acesso autenticado, a próxima etapa será descrever sua API para que os Aplicativos Lógicos, o Power Automate ou o Power Apps possa se comunicar com sua API. As seguintes abordagens têm suporte:
Uma definição OpenAPI (anteriormente conhecida como um arquivo Swagger)
Uma coleção Postman
Comece do zero usando o portal do conector personalizado (somente Power Automate e Power Apps)
Definições OpenAPI e coleções Postman usam formatos diferentes, mas ambos são documentos legíveis por computador independente de linguagem que descrevem sua API. Você pode gerar esses documentos por meio de várias ferramentas, com base na linguagem e plataforma usadas pela sua API. Nos bastidores, Aplicativos Lógicos, o Power Automate e o Power Apps usam OpenAPI para definir conectores.
4. Use seu conector em um Aplicativo Lógico, aplicativo do Power Automate ou do Power Apps
Os conectores personalizados são usados da mesma forma que os conectores predefinidos. Você deverá criar uma conexão com sua API para usar essa conexão para chamar qualquer operação exposta 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, você pode reutilizar a definição OpenAPI ou coleção Postman para recriar o conector em qualquer um desses serviços. Para obter mais informações, consulte o tutorial adequado:
- Use um conector personalizado de um fluxo
- Use um conector personalizado de um aplicativo
- Use um conector personalizado de um aplicativo lógico
Dica
Se você atualizar (remover, adicionar ou alterar) um campo na API, execute estas etapas:
- Publique novamente o conector para que ele observe o Swagger atualizado para a API.
- Remova qualquer conexão/fonte de dados em qualquer aplicativo que tenha usado esse conector.
- Adicione novamente a conexão/fonte de dados desse conector nos aplicativos.
5. Compartilhe seu conector
Você pode compartilhar seu conector com usuários em sua organização da mesma forma que compartilha recursos em Aplicativos Lógicos, Power Automate, ou Power Apps. O compartilhamento é opcional, mas talvez você tenha cenários em que queira compartilhar seus conectores com outros usuários.
Saiba mais em Compartilhe conectores personalizados em sua organização.
6. Certifique seu conector
Se quiser compartilhar seu conector com todos os usuários dos Aplicativos Lógicos, do Power Automate e do Power Apps, você poderá enviá-lo para certificação da Microsoft. A Microsoft examinará o conector, verificará a conformidade técnica e de conteúdo, e validará a funcionalidade.
Para obter mais informações, consulte Enviar seus conectores para certificação Microsoft.
Suporte à Rede Virtual
Quando o conector é usado em um Power Platform ambiente vinculado a uma Rede Virtual, as limitações se aplicam:
Quando código personalizado é usado, as limitações são explicadas em Escrever código em um conector personalizado.
Conectores personalizados criados antes do ambiente ser associado a uma Rede Virtual precisam ser salvos novamente.
Os gatilhos que retornam cabeçalhos de localização que não chamam de volta o conector personalizado não são suportados.
Faça comentários
Agradecemos muito os comentários sobre problemas com nossa plataforma de conectores ou novas ideias de recursos. Para fornecer feedback, acesse Enviar problemas ou obter ajuda com conectores e selecione seu tipo de feedback.