Introduzione
Questo modulo descrive i connettori personalizzati e spiega come configurarli e usarli con Microsoft Power Apps, Microsoft Power Automate e App per la logica di Microsoft Azure.
Contenuto del modulo:
Informazioni sul ruolo dei connettori personalizzati.
Creazione di un connettore e suo impiego in un flusso Power Automate.
I connettori aiutano i creatori di app e flussi a semplificare la connessione ad altre app, dati e dispositivi nel cloud nei modi seguenti:
La connessione viene eseguita in modo coerente e ripetibile, così da poter essere rilevata dai creatori.
I connettori dispongono di azioni che consentono ai creatori di controllare quando viene eseguita un'operazione.
Possono avere trigger che consentono l'avvio dell'automazione quando si verifica l'evento di attivazione.
Un connettore è un proxy o un wrapper intorno a un'API che consente al servizio sottostante di comunicare con Power Automate, Power Apps e App per la logica. Molti connettori sono predefiniti e disponibili per l'uso senza necessità di ulteriori definizioni. Queste definizioni dei connettori predefiniti includono i servizi di Microsoft e altri. Quando il servizio o l'API che si vuole usare non dispone di un connettore predefinito, è possibile crearne uno personalizzato. Se un connettore predefinito non espone tutti i trigger e le azioni di cui hai bisogno nell'API, è possibile creare un connettore personalizzato in aggiunta a quello disponibile per gestire questi ulteriori requisiti. Dopo averlo definito, il connettore personalizzato diventa disponibile per l'uso quando si creano app e flussi nell'ambiente, con modalità simili ai connettori predefiniti.
Identificazione o creazione dell'API
La prima attività da eseguire è controllare il riferimento del connettore per determinare se esiste già un connettore adatto per l'API/servizio. Se non esiste, è possibile creare un connettore personalizzato. È possibile definire il connettore personalizzato per descrivere qualsiasi API REST pubblica (disponibile su Internet) o privata (disponibile solo sulla rete interna). Le API private richiedono il gateway dati locale per accedere alle risorse interne.
Se non esiste un'API compatibile, gli sviluppatori possono crearne una usando qualsiasi tecnologia in grado di ospitare un'API REST, tra cui Funzioni di Microsoft Azure e Servizi app di Azure. È anche possibile usare Gestione API di Azure per aumentare la gestibilità e la governance delle API.
Descrizione dell'API
Per consentire a Power Apps e Power Automate di scoprire quali trigger e azioni sono disponibili nell'API, è necessario identificarli quando si crea il connettore personalizzato. Per farlo, modificare manualmente la definizione del connettore nel portale per creatori o importare una definizione in un formato supportato. Questo processo include l'identificazione dei requisiti di autenticazione per l'API.
Uso del connettore
Dopo essere stati creati in un ambiente, i connettori personalizzati si possono usare allo stesso modo dei connettori predefiniti. Questi connettori possono essere usati anche in un ambiente diverso da quello di creazione. La definizione del connettore deve essere esportata dall'ambiente in cui è stata creata e quindi importata in qualsiasi ambiente in cui sia necessaria. È anche possibile condividere il connettore con altre persone per consentire loro di usarlo come una risorsa condivisa.
Certificazione e condivisione del connettore come open source
Poiché i connettori personalizzati sono disponibili solo negli ambienti in cui esiste la loro definizione, non sono accessibili agli altri clienti Microsoft. Condividendo la definizione di un connettore personalizzato come open source, la si rende disponibile su GitHub affinché altri clienti possano importarla nei loro ambienti. Certificando il connettore, è possibile rendere disponibile il connettore personalizzato come connettore predefinito in tutti gli ambienti dei clienti. La certificazione di un connettore richiede la proprietà dell'API o un'autorizzazione esplicita da parte del proprietario dell'API per la pubblicazione di un connettore.
Per altre informazioni, vedere il processo di certificazione.
Questo passaggio del processo è facoltativo. Diventa obbligatorio solo se si vuole che il connettore sia condiviso e certificato. I connettori esclusivamente interni non devono completare questo processo di certificazione.
Descrizione del connettore
Per definire le azioni e i trigger di un connettore, è necessario descriverlo. Un connettore personalizzato può essere definito descrivendo solo i trigger e le azioni dell'API di cui c'è bisogno. Ad esempio, se un'API ha 100 azioni e 10 trigger disponibili, è possibile creare un connettore personalizzato con una singola azione. Se le esigenze cambiano, è possibile aggiungere una descrizione successivamente.
Quando si descrive l'API, si deve usare almeno uno dei seguenti approcci. Se si sceglie di importare una definizione OpenAPI, è comunque possibile modificare manualmente la definizione del connettore nel portale.
Creazione manuale nel portale: con questo approccio vengono usati la documentazione dell'API e gli esempi di input e output, quindi si definiscono i singoli trigger e azioni. Questo approccio è utile per lavorare con API semplici che non consentono di importare la definizione oppure per perfezionare le definizioni dopo averle importate.
Importazione della definizione OpenAPI: OpenAPI è una specifica che descrive REST, semplificando le attività di sviluppo e utilizzo di un'API grazie a un mapping efficace di tutte le risorse e delle operazioni associate. Molti servizi/API pubblicano una definizione OpenAPI che è possibile importare per descrivere l'API nel connettore personalizzato. L'importazione della versione 2.0 è supportata, ma la versione 3.0 non è al momento supportata. Questo approccio è utile se l'editore dell'API ha reso disponibile una definizione OpenAPI; in alternativa, se ne può pubblicare una se si sta sviluppando personalmente l'API.
Importazione da GitHub: consente di importare i connettori dal repository dei connettori di Power Platform. Questo è l'approccio migliore quando c'è già un connettore pubblicato nel repository e si desidera importarlo per modificarlo o usarlo come connettore personalizzato.
Esportazione da Azure: se l'API viene creata con Servizio app di Azure o Funzioni di Microsoft Azure oppure viene gestita con Gestione API di Microsoft Azure, è possibile esportarla da questi servizi e creare automaticamente la definizione del connettore personalizzato iniziale.
Uso delle API autenticate
L'architettura del connettore personalizzato supporta l'uso di API autenticate. Quando si definisce il connettore personalizzato, va specificato come deve eseguire l'autenticazione nell'API. Le scelte di autenticazione supportano l'accesso anonimo, protetto da password, OAuth 2.0 e chiave API.
Nessuna autenticazione: questa opzione è per le API che consentono l'accesso anonimo ed è l'impostazione predefinita se non si configura un tipo di autenticazione specifico.
Autenticazione di base: questa opzione è per le API che richiedono l'invio di un nome utente e di una password per ogni richiesta.
OAuth 2.0 - OAuth 2.0 è il protocollo standard del settore delle autorizzazioni. Questa opzione può essere configurata per qualsiasi API compatibile con OAuth 2.0. In servizi Microsoft come Microsoft Entra ID, GitHub e Azure DevOps, sono disponibili varie scelte di configurazioni predefinite. Altre configurazioni predefinite simili sono disponibili per servizi come Dropbox, Slack, Stripe e così via. Le configurazioni predefinite semplificano le operazioni di configurazione del provider di identità.
Chiave API: una chiave API è un token che un client fornisce quando effettua chiamate API. La chiave in genere viene fornita dall'editore dell'API e deve essere inclusa in ogni richiesta del connettore personalizzato.
I connettori personalizzati aiutano i creatori di app e flussi a semplificare l'uso di API/servizi. In generale, i creatori potrebbero richiamare direttamente l'API senza un connettore. Tuttavia, dovrebbero sapere come comporre la richiesta, interpretare i risultati e gestire l'autenticazione. Questo processo dovrebbe essere completato ogni volta che l'app o il flusso usa i connettori personalizzati.
Inoltre, i creatori non riescono sempre a creare connettori personalizzati con trigger in grado di attivare i flussi al verificarsi di specifici eventi. I connettori personalizzati consentono di capire più facilmente come usare le azioni e i relativi risultati quando si crea un'app o un flusso che usa il connettore.
La prossima unità spiega come creare un connettore personalizzato.