Visão geral do ciclo de vida de conector personalizado

Concluído

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):

É 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:

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.