Condividi tramite

Panoramica dei connettori personalizzati

Anche se App per la logica di Azure, Microsoft Power Automate, Microsoft Power Apps e offrono oltre 1.000 connettori per connettersi a servizi Microsoft e verificati e Microsoft Copilot Studio può usare i connettori predefiniti; potrebbe 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 Analisi del testo 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, Power Apps o Copilot Studio 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 usano OAuth 2.0 per l'autenticazione automatica hanno un URI di reindirizzamento per connettore. I connettori OAuth 2.0 esistenti devono essere aggiornati in modo da 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".
  • Dopo aver aggiornato i connettori personalizzati in modo da utilizzare l'URI di reindirizzamento per connettore tramite l'impostazione nella scheda Sicurezza o nello strumento CLI, rimuovi l'URI di reindirizzamento globale dalle app OAuth 2.0. Dovresti aggiungere l'URL di reindirizzamento univoco appena generato alle tue app OAuth 2.0.
  • Questo aggiornamento verrà applicato ai connettori personalizzati OAuth 2.0 esistenti a partire dal 17 febbraio 2024. Qualsiasi connettore personalizzato non aggiornato per l'uso di un URI di reindirizzamento per connettore smette di funzionare per le nuove connessioni e mostra un messaggio di errore all'utente.
  • Per scoprire per quali connettori personalizzati è necessario un aggiornamento per la migrazione a un URL di reindirizzamento del connettore, puoi creare un flusso che usa l'azione Recupera connettori personalizzati come amministratore del connettore Power Apps per amministratori e analizzare 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 escludere i connettori personalizzati non OAuth, seguita da un altro filtro per selezionare solo i connettori che non usano 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, Power Apps o Copilot Studio 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, Power Apps e Copilot Studio usare OpenAPI per definire i connettori.

4. Utilizza il connettore in Copilot Studio, App per la logica, Power Automate, o un'app 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 e Copilot Studio, i connettori creati in Power Apps sono disponibili in Power Automate e Copilot Studio. Questa disponibilità non si applica ai connettori creati nelle 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, effettua questi passaggi:

  1. Ripubblica il connettore in modo che esamini la versione aggiornata di Swagger per l'API.
  2. Rimuovi qualsiasi connessione/origine dati in qualsiasi app che ha usato quel connettore.
  3. Aggiungi nuovamente la connessione o l'origine dati per quel connettore nelle app.

5. Condividi il connettore

Puoi condividere il connettore con gli utenti della tua organizzazione nello stesso modo in cui condividi risorse in Copilot Studio, App per la logica, Power Automate o Power Apps. La condivisione è facoltativa, ma potresti avere scenari in cui desideri condividere i tuoi connettori con altri utenti.

Altre informazioni in Condividere connettori personalizzati nell'organizzazione.

6. Certifica il connettore

Se desideri condividere il connettore con tutti gli utenti di Copilot Studio, App per la logica, Power Automate e Power Apps, devi 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à.

Supporto di Rete virtuale

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

  • Quando viene usato codice personalizzato: le limitazioni sono illustrate in Scrivere codice in un connettore personalizzato.

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

  • I trigger che restituiscono l'intestazione di localizzazione e che non richiamano 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 fornire un feedback, vai a Inviare problemi o ottenere assistenza per i connettori e seleziona il tipo di commenti.