Panoramica dei connettori personalizzati

  • Articolo

Anche se App per la logica di Azure, Microsoft Power Automate e Microsoft Power Apps offrono oltre 1.000 connettori per connettersi a servizi Microsoft e verificati, può essere necessario comunicare con servizi che non sono disponibili come connettori predefiniti. I connettori personalizzati consentono di rispondere alle esigenze di questo scenario, nonché di creare e condividere un connettore con trigger e azioni specifici.

Screenshot che mostra come i connettori personalizzati collegano l'API Text Analytics con le app.

Ciclo di vita

Screenshot del ciclo di vita dei connettori personalizzati in cinque fasi.

1. Crea la tua API

Un connettore personalizzato è un wrapper attorno a un'API REST che consente ad App per la logica, Power Automate o Power Apps di comunicare con quell'API REST o SOAP. Queste API possono essere:

  • Pubbliche (visibili pubblicamente su Internet), ad esempio Spotify, Slack, Rackspace o altre API che gestisci.
  • Private (visibili solo sulla tua rete).

App per la logica supporta anche le API SOAP.

Per le API pubbliche che prevedi di creare e gestire, considera l'utilizzo di uno di questi prodotti Microsoft Azure:

Per le API private, Microsoft offre connettività dei dati locale tramite un gateway dati locale.

2. Proteggi l'API

Utilizza uno di questi metodi di autenticazione standard per le API e i connettori (Microsoft Entra ID è la scelta consigliata):

Puoi impostare l'autenticazione Microsoft Entra ID per la tua API nel portale di Azure così da non dover implementare l'autenticazione. In alternativa, puoi richiedere e applicare l'autenticazione nel codice della tua API. Per altre informazioni su Microsoft Entra ID per connettori personalizzati, vedi Proteggere l'API e il connettore con Microsoft Entra ID.

2.1. OAuth 2.0

I connettori personalizzati appena creati che utilizzano OAuth 2.0 per l'autenticazione automatica dispongono di un URI di reindirizzamento per connettore. I connettori OAuth 2.0 esistenti devono essere aggiornati per utilizzare un URI di reindirizzamento per connettore prima del 17 febbraio 2024.

  • Se hai creato i tuoi connettori personalizzati con l'interfaccia Web, modifica i connettori personalizzati, vai alla scheda Sicurezza e seleziona la casella Aggiorna a connettori univoci URL di reindirizzamento, quindi salva per abilitare l'URI di reindirizzamento per connettore.
  • Se hai creato i tuoi connettori personalizzati con autenticazioni multiple utilizzando lo strumento CLI (Command Line Interface), devi aggiornare il tuo connettore utilizzando lo strumento CLI per impostare "redirectMode": "GlobalPerConnector".
  • Una volta aggiornati i connettori personalizzati per utilizzare l'URI di reindirizzamento per connettore tramite l'impostazione nella scheda Sicurezza o tramite lo strumento CLI, rimuovi l'URI di reindirizzamento globale dalle tue app OAuth 2.0. È necessario aggiungere l'URL di reindirizzamento univoco appena generato alle app OAuth 2.0.
  • Applicheremo questo aggiornamento per i connettori personalizzati OAuth 2.0 esistenti a partire dal 17 febbraio 2024. Qualsiasi connettore personalizzato non aggiornato per utilizzare un URI di reindirizzamento per connettore smette di funzionare per le nuove connessioni e mostra un messaggio di errore all'utente.
  • Per scoprire a quali connettori personalizzati è necessario un aggiornamento per migrare per URL di reindirizzamento del connettore, puoi creare un flusso che utilizza l'azione Ottieni connettori personalizzati come amministratore di Power Apps per il connettore amministratore e analizzarne il risultato. Il flusso allegato più avanti in questo articolo recupera tutti i connettori personalizzati utilizzando lo stesso. Quindi applica una condizione di filtro sulla proprietà del parametro di connessione per filtrare il connettore personalizzato non Oauth, seguito da un altro filtro per selezionare solo i connettori che non utilizzano l'URL di reindirizzamento univoco per connettore. Infine, inserisce i connettori personalizzati selezionati in una variabile della matrice inizializzata all'inizio del flusso e genera una tabella HTML che mostra il nome e il creatore di tali connettori. Puoi importare questo flusso nel tuo ambiente importando questa soluzione. Puoi estendere ulteriormente il flusso per inviare la tabella HTML come e-mail a te stesso. oppure puoi estenderlo per inviare e-mail direttamente ai creatori del connettore e fornire loro i nomi del connettore che deve essere aggiornato.

3. Descrivi l'API e definisci il connettore personalizzato

Una volta che hai un'API con accesso autenticato, la prossima cosa da fare è descrivere l'API in modo che App per la logica, Power Automate o Power Apps possano comunicare con la tua API. Sono supportate gli approcci seguenti:

Le definizioni OpenAPI e le raccolte Postman usano formati differenti, ma sono entrambi documenti indipendenti dal linguaggio e in un formato leggibile al computer che descrivono l'API. Puoi generare questi documenti da vari strumenti in base al linguaggio e alla piattaforma usati dall'API. Dietro le quinte, App per la logica, Power Automate, e Power Apps OpenAPI per definire i connettori.

4. Utilizza il connettore in App per la logica, Power Automate o Power Apps

I connettori personalizzati vengono usati in modo analogo ai connettori predefiniti. Dovrai creare una connessione nella tua API per chiamare le operazioni esposte nel tuo connettore personalizzato.

I connettori creati in Power Automate sono disponibili in Power Apps, mentre i connettori creati in Power Apps sono disponibili in Power Automate. Questa disponibilità non è valida per i connettori creati in App per la logica. Tuttavia, puoi riutilizzare la definizione OpenAPI o la raccolta Postman per ricreare il connettore in uno qualsiasi di questi servizi. Per ulteriori informazioni, vedi l'esercitazione appropriata.

Suggerimento

Se aggiorni (rimuovi, aggiungi o modifichi) un campo nell'API, procedi come segue:

  1. Ripubblicare il connettore in modo che prenda in considerazione lo Swagger aggiornato per l'API.
  2. Rimuovere qualsiasi connessione / origine dati in qualsiasi app che abbia utilizzato quel connettore.
  3. Aggiungere nuovamente la connessione / origine dati per quel connettore nelle app.

5. Condividi il connettore

Puoi condividere il connettore con tutti gli utenti dell'organizzazione nello stesso modo in cui condividi le risorse nelle app per la logica, in Power Automate o in Power Apps. La condivisione è facoltativa, ma potresti avere scenari in cui desideri condividere i tuoi connettori con altri utenti.

Per ulteriori informazioni, consulta Condividi connettori personalizzati nella tua organizzazione.

6. Certifica il connettore

Per condividere il connettore con tutti gli utenti di App per la logica, Power Automate e Power Apps, puoi inviarlo a Microsoft per ottenere la certificazione. Microsoft verifica il connettore, controlla la conformità tecnica e del contenuto del connettore e quindi ne convaliderà la funzionalità.

Per altre informazioni, vedi Inviare connettori per la certificazione Microsoft.

Supporto di Rete virtuale

Quando il connettore viene usato in un ambiente Power Platform collegato a una rete virtuale, si applicano le limitazioni:

  • Quando si utilizza codice personalizzato, le limitazioni sono spiegate in Scrivere codice in un connettore personalizzato.

  • I connettori personalizzati creati prima che ambiente fosse associato a una rete virtuale devono essere salvati nuovamente.

Inviare commenti

L'invio da parte degli utenti di feedback sui problemi riscontrati con la piattaforma di connettori o di idee su nuove funzionalità è molto apprezzato. Per fornire un feedback, vai a Inviare problemi o ottenere assistenza per i connettori e seleziona il tipo di commenti.