Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
App per la logica di Azure, Microsoft Power Automate, Microsoft Power Apps, Microsoft Copilot Studio e Microsoft Copilot (tramite Microsoft Copilot plugins) offrono oltre 1.000 connettori per connettersi ai servizi Microsoft e ai servizi verificati. Tuttavia, potrebbe essere necessario comunicare con servizi non 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.
Ciclo di vita
1. Crea la tua API
Un connettore personalizzato è un wrapper intorno a un'API REST che consente a Logic Apps, flussi di Power Automate, Power Apps, agenti e flussi di lavoro di Copilot Studio o plug-in di Microsoft Copilot di comunicare con tale 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).
Logic Apps 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):
- OAuth 2.0 generico
- OAuth 2.0 per servizi specifici tra cui Microsoft Entra ID, Dropbox, GitHub e SalesForce
- Autenticazione di base
- Chiave API
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
Connettori personalizzati che usano OAuth 2.0 per l'autenticazione usano un URI di reindirizzamento per connettore. Se sono stati creati connettori personalizzati precedenti prima di febbraio 2024 che usano l'URI di reindirizzamento globale, tali connettori sono stati aggiornati o interrotti a funzionare per le nuove connessioni dopo l'applicazione dell'URI di reindirizzamento per connettore.
- 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.
- 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
Dopo aver creato un'API con accesso autenticato, descrivere l'API in modo che App per la logica, Power Automate, Power Apps, Copilot Studio o Microsoft Copilot possano comunicare con l'API. È possibile usare gli approcci seguenti:
Una definizione OpenAPI, nota in precedenza come file Swagger
Una raccolta Postman
Inizia da zero utilizzando il portale del connettore personalizzato (solo Power Automate e Power Apps)
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, Copilot Studio e plug-in di Microsoft Copilot usano OpenAPI per definire i connettori.
4. Usare il connettore nei plug-in di Microsoft Copilot, Copilot Studio, Logic Apps, Power Automate o un'app di Power Apps
I connettori personalizzati vengono usati in modo analogo ai connettori predefiniti. Devi creare una connessione alla tua API per usare tale connessione per chiamare tutte le operazioni che esponi nel tuo connettore personalizzato.
I connettori creati in Power Automate o Power Apps sono disponibili in:
- Power Apps
- Flussi cloud di Power Automate
- Copilot Studio agenti e flussi di lavoro
- plug-in di Microsoft Copilot
I connettori creati in Logic Apps non hanno lo stesso ambito di disponibilità. Tuttavia, puoi riutilizzare la definizione OpenAPI o la raccolta Postman per ricreare il connettore in uno qualsiasi di questi servizi. Per ulteriori informazioni, vedere il tutorial corrispondente:
- Usare un connettore personalizzato da un flusso
- Usare un connettore personalizzato da un'app
- Usare un connettore personalizzato da una Logic App
- Usare le azioni del connettore in Copilot Studio
Suggerimento
Se aggiorni (rimuovi, aggiungi o modifichi) un campo nell'API, effettua questi passaggi:
- Ripubblica il connettore in modo che esamini la versione aggiornata di Swagger per l'API.
- Rimuovi qualsiasi connessione/origine dati in qualsiasi app che ha usato quel connettore.
- Aggiungi di nuovo la connessione/l'origine dati per quel connettore nelle app.
5. Condividi il connettore
È possibile condividere il connettore con gli utenti dell'organizzazione, in modo analogo a come si condividono le 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
Per condividere il connettore con tutti gli utenti di Microsoft Copilot, Copilot Studio, App per la logica, Power Automate e Power Apps, è necessario inviare il connettore per la certificazione Microsoft. Microsoft verifica il connettore, controlla la conformità tecnica e del contenuto del connettore e quindi ne convaliderà la funzionalità. conformità e convalida 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.
- Le richieste OAuth e di token non transitano attraverso la rete virtuale collegata. Solo le richieste agli endpoint API lo fanno.
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.