Panoramica del ciclo di vita del connettore personalizzato
Prima di avviare la creazione di connettori personalizzati, è necessario conoscere in dettaglio ognuno dei passaggi del ciclo di vita del connettore personalizzato. Il diagramma seguente illustra tutte le attività necessarie per la creazione e l'uso dei connettori personalizzati.
Creazione e protezione dell'API
Un connettore personalizzato è un wrapper intorno a un'API REST che consente a un servizio sottostante di comunicare con Power Apps, Power Automate o App per la logica di Azure. Prima di iniziare a creare connettori personalizzati, assicurarsi che sia presente un'API completamente funzionante.
È possibile usare qualsiasi linguaggio e qualsiasi piattaforma per l'API, purché sia resa disponibile come API REST o API SOAP. Di seguito vengono forniti alcuni esempi:
API disponibili pubblicamente, ad esempio NOAA, Census Bureau degli Stati Uniti o Portale Open Data dell'Unione Europea.
Un'API creata e distribuita in qualsiasi provider di hosting cloud, ad esempio Azure, Heroku o Google Cloud.
Un'API privata (visibile solo alla rete dell'utente), con connettività disponibile tramite un gateway dati locale.
Un'API line-of-business personalizzata distribuita nella rete. È possibile connettersi all'API se è questa è disponibile su Internet pubblico oppure ci si può connettere all'API tramite un gateway (attualmente disponibile in Power Automate e Power Apps).
Per le tecnologie Microsoft, è consigliabile una di queste piattaforme:
Per proteggere l'API e i connettori, si può usare uno di questi metodi di autenticazione standard (Microsoft Entra ID è il metodo consigliato):
OAuth 2.0 per servizi specifici, come Microsoft Entra ID, Dropbox, GitHub e Salesforce
È possibile configurare l'autenticazione di Microsoft Entra ID per l'API nel portale di Azure, in modo da non dover implementare l'autenticazione tramite codice. Se necessario, è possibile richiedere e applicare l'autenticazione attraverso il codice dell'API. Per altre informazioni su Microsoft Entra ID per i connettori personalizzati, consultare Autenticare l'API e il connettore con Microsoft Entra ID.
Descrizione dell'API e definizione del connettore personalizzato
Dopo aver creato un'API, il passaggio successivo prevede di stabilire come descrivere l'interfaccia dell'API e le relative operazioni in modo da permettere la comunicazione con Power Apps, Power Automate e App per la logica di Azure. Dopo avere determinato come descrivere l'API è possibile creare il connettore, che la registra nei servizi appropriati.
Usare uno degli approcci seguenti per descrivere l'API:
Una definizione OpenAPI, nota in precedenza come file Swagger. Per altre informazioni, consultare Creare un connettore personalizzato da una definizione OpenAPI e Informazioni su Swagger.
È inoltre possibile iniziare con una connessione personalizzata vuota usando la procedura guidata del connettore personalizzato in Power Apps e Power Automate. Per altre informazioni consultare Creare un connettore personalizzato da zero.
Le definizioni OpenAPI usano formati diversi, che hanno in comune il fatto di essere documenti indipendenti dal linguaggio e leggibili dai computer, che descrivono le operazioni e i parametri dell'API. È possibile generare questi documenti da vari strumenti, in base al linguaggio e alla piattaforma usati dall'API. Dietro le quinte, Power Apps, Power Automate e App per la logica di Azure usando OpenAPI per definire i connettori.
Uso del connettore personalizzato
È possibile usare il connettore personalizzato nello stesso modo in cui si usa qualunque connettore predefinito. È possibile creare una connessione all'API e chiamare qualsiasi operazione fornita dall'API allo stesso modo in cui vengono chiamate le operazioni per i connettori predefiniti.
I connettori creati in Power Apps o Power Automate possono essere usati in entrambi i servizi, mentre i connettori creati in App per la logica di Azure non possono essere usati direttamente in altri servizi. Tuttavia, è possibile ricreare facilmente un connettore con la stessa definizione OpenAPI usata per creare il connettore per App per la logica di Azure.
Per altre informazioni sull'uso dei connettori personalizzati da Power Apps, Power Automate e App per la logica di Azure:
Condivisione del connettore personalizzato
I connettori possono essere condivisi con altri utenti dell'organizzazione nello stesso modo in cui si condividono le risorse in Power Apps, Power Automate e App per la logica. La condivisione è facoltativa, ma potrebbe capitare di operare in scenari in cui è necessario condividere il connettore con altri utenti. Per altre informazioni, consultare Condividere un connettore personalizzato nell'organizzazione.
Certificazione del connettore personalizzato
Per condividere il connettore con tutti gli utenti in Power Apps, Power Automate e App per la logica, è possibile inviarlo per la certificazione Microsoft. Durante questo processo, Microsoft esamina il connettore, verifica la conformità tecnica e del contenuto e convalida la funzionalità. Per altre informazioni, consultare Inviare il connettore per la certificazione Microsoft.