Condividi tramite

Panoramica dei connettori personalizzati

  • Articolo

Sebbene Azure Logic Apps, Microsoft Power Automate e Microsoft Power Apps offrano oltre 1.000 connettori per connettersi a servizi Microsoft e verificati, potresti voler 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:

  • Pubblico (visibile sulla rete Internet pubblica), ad esempio Spotify, Slack, Rackspace o un'API da te gestita.
  • 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à dati in locale tramite un gateway dati in locale.

2. Proteggi l'API

Utilizza uno di questi metodi di autenticazione standard per le tue API e i tuoi connettori (si consiglia Microsoft Entra ID ):

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 maggiori informazioni sull' Microsoft Entra ID per i connettori personalizzati, consulta Proteggi la tua API e il connettore con l' Microsoft Entra ID.

2.1. OAuth 2.0

I connettori personalizzati di nuova creazione che utilizzano OAuth 2.0 per l'autenticazione automatica dispongono di un URI di reindirizzamento per connettore. I connettori esistenti OAuth 2.0 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, modificali, vai alla scheda Sicurezza e seleziona la casella Aggiorna a URL di reindirizzamento univoco, quindi salva per abilitare l'URI di reindirizzamento per connettore.
  • Se hai creato i tuoi connettori personalizzati con multi-auth utilizzando lo strumento dell'interfaccia a riga di comando (CLI), devi aggiornare il 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 lo strumento CLI, rimuovi l'URI di reindirizzamento globale dalle tue app OAuth 2.0. Dovresti aggiungere l'URL di reindirizzamento univoco appena generato alle tue app OAuth 2.0.
  • Applicheremo questo aggiornamento ai connettori personalizzati 2.0 esistenti a partire dal 17 febbraio 2024. OAuth 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. Applica quindi una condizione di filtro sulla proprietà del parametro di connessione per filtrare i connettori personalizzati non OAuth, seguita 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 Logic Apps. 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/fonte 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 la sezione 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 ulteriori informazioni, consulta Invia i tuoi connettori per la certificazione Microsoft.

Supporto di Rete virtuale

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

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

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

  • I trigger che restituiscono un'intestazione di posizione che non richiama il connettore personalizzato non sono supportati.

Fornire 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 inviare un feedback, vai su Segnala problemi o ottieni assistenza con i connettori e seleziona il tipo di feedback.