Visão geral do ciclo de vida de conector personalizado
Antes de começar a criar conectores personalizados, você precisa saber todos os detalhes de cada uma das etapas envolvidas no ciclo de vida do conector personalizado. O diagrama a seguir mostra as tarefas envolvidas na criação e no uso de conectores personalizados.
Criar e proteger sua API
Um conector personalizado é um wrapper em torno de uma API REST que permite que um serviço subjacente se comunique com o Power Apps, o Power Automate ou os Aplicativos Lógicos do Azure. Tenha uma API totalmente operacional antes de começar a criar conectores personalizados.
É possível usar qualquer linguagem e plataforma para sua API, desde que ela seja disponibilizada como uma API REST ou API SOAP. Veja alguns exemplos:
APIs disponíveis publicamente, como NOAA, US Census API ou EU Open Data Portal.
Uma API que você cria e implanta em qualquer provedor de hospedagem de nuvem, como Azure, Heroku ou Google Cloud.
Uma API privada (visível apenas para a sua rede), com conectividade disponível por meio de um gateway de dados local.
Uma API de linha de negócios personalizada implantada em sua rede. Será possível se conectar à API se ela estiver disponível na Internet pública ou por meio de um gateway (disponível atualmente no Power Automate e no Power Apps).
Para tecnologias da Microsoft, é recomendável uma destas plataformas:
Para proteger a API e os conectores, você pode usar um destes métodos de autenticação padrão (Microsoft Entra ID é recomendável):
OAuth 2.0 para serviços específicos, como Microsoft Entra ID, Dropbox, GitHub e Salesforce
É possível configurar a autenticação do Microsoft Entra ID para sua API no portal do Azure para que não seja preciso implementar a autenticação pelo código. Se necessário, você pode exigir e aplicar a autenticação por meio do código da API. Para obter mais informações sobre o Microsoft Entra ID para conectores personalizados, consulte Proteger a API e o conector com o Microsoft Entra ID.
Descrever a API e definir o conector personalizado
Depois que você tiver uma API, a etapa seguinte a ser considerada é como descrever a interface da API e suas operações para que o Power Apps, o Power Automate e os Aplicativos Lógicos do Azure possam se comunicar com a API. Depois de determinar como descrever a API, você pode criar o conector, que a registra com os serviços apropriados.
Use um dos seguintes procedimentos para descrever a API:
Uma definição de OpenAPI (anteriormente conhecida como um arquivo Swagger). Para obter mais informações, consulte Criar um conector personalizado de uma OpenAPI e O que é o Swagger.
Você também pode começar com uma conexão personalizada em branco usando o assistente de conector personalizado no Power Apps e no Power Automate. Para obter mais informações, consulte Criar um conector personalizado do zero.
As definições da OpenAPI usam um formato diferente, mas são documentos independentes de linguagem e legíveis por máquina que descrevem as operações e os parâmetros de 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, o Power Apps, o Power Automate e os Aplicativos Lógicos usam OpenAPI para definir conectores.
Usar o conector personalizado
Você pode usar seu conector personalizado da mesma maneira que usa qualquer conector interno. Você cria a conexão com a API e chama todas as operações fornecidas pela API da mesma maneira que chama operações para conectores internos.
Os conectores criados no Power Apps ou no Power Automate podem ser usados em ambos os serviços, mas os conectores criados nos Aplicativos Lógicos do Azure não podem ser usados diretamente em outros serviços. No entanto, um conector pode ser facilmente recriado usando a mesma definição do OpenAPI usada para criar o conector de Aplicativos Lógicos do Azure.
Para obter mais informações sobre o uso de conectores personalizados do Power Apps, do Power Automate e dos Aplicativos Lógicos do Azure:
Compartilhar o conector personalizado
Os conectores podem ser compartilhados com outros usuários em sua organização da mesma forma como você compartilha recursos no Power Apps, no Power Automate e nos Aplicativos Lógicos. O compartilhamento é opcional, mas pode haver cenários em que você precise compartilhar o conector com outros usuários. Saiba mais em Compartilhar um conector personalizado em sua organização.
Certificar o conector personalizado
Se desejar compartilhar o conector com todos os usuários no Power Apps, no Power Automate e nos Aplicativos Lógicos, você poderá enviar o conector para a certificação da Microsoft. Durante esse processo, a Microsoft analisa o conector, verifica a conformidade técnica e de conteúdo e valida a funcionalidade. Saiba mais em Enviar seu conector para certificação da Microsoft.