Dela via

Anpassade anslutningsprogram – en översikt

Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps och Microsoft Copilot Studio erbjuder över 1 000 anslutningsappar för att ansluta till Microsoft och verifierade tjänster, men du kanske vill kommunicera med tjänster som inte är tillgängliga som fördefinierade anslutningsappar. Anpassade anslutningsprogram hanterar det här scenariot genom att göra det möjligt för dig att skapa (och även dela) en anslutningsapp med egna utlösare och åtgärder.

Skärmbild som visar hur anpassade anslutningsappar överbryggar API:et för textanalys med appar.

Livscykel

Skärmbild av livscykeln för anpassade anslutningsappar i fem steg.

1. Bygg upp ditt API

En anpassad anslutningsapp är en omslutning runt ett REST API som gör att Logic Apps, Power Automate, Power Apps, eller Copilot Studio kommunicerar med det REST- eller SOAP-API:et. API:erna kan vara:

  • Offentlig (synlig på det offentliga internet) som Spotify , Slack , Rackspace eller ett API somdu hanterar.
  • Privat (visas endast för nätverket).

Logic Apps stöder även SOAP-API:er.

För offentliga API:er som du planerar att skapa och hantera bör du överväga att använda någon av dessa Microsoft Azure-produkter:

För privata API:er erbjuder Microsoft lokal dataanslutning via en lokal datagateway.

2. Skydda ditt API

Använd någon av dessa standardautentiseringsmetoder för dina API:er och anslutningsappar (Microsoft Entra ID rekommenderas):

Du kan konfigurera Microsoft Entra ID-autentisering för ditt API i Azure-portalen så att du inte behöver implementera autentiseringen. Du kan också kräva och framtvinga autentisering i API-koden. Mer information om Microsoft Entra ID för anpassade anslutningsappar finns i Skydda ditt API och anslutningsprogram med Microsoft Entra ID.

2.1. OAuth 2.0 OAuth 2.0

Nyligen skapade anpassade anslutningsappar som använder OAuth 2.0 för att autentisera automatiskt har en omdirigerings-URI per anslutningsapp. Befintliga OAuth 2.0-anslutningsappar måste uppdateras för att använda en omdirigerings-URI per anslutningsapp före den 17 februari 2024.

  • Om du har skapat dina anpassade anslutningsprogram med webbgränssnittet redigerar du dina anpassade anslutningsprogram, går till fliken Säkerhet och markerar kryssrutan Uppdatera till unik omdirigerings-URL och sparar sedan för att aktivera omdirigerings-URI:n per anslutningsapp.
  • Om du har skapat dina anpassade anslutningsappar med multiautentisering med hjälp av CLI-verktyget (command line interface) måste du uppdatera anslutningsappen med hjälp av CLI-verktyget för att ställa in "redirectMode": "GlobalPerConnector".
  • När anpassade anslutningsappar har uppdaterats för att använda omdirigerings-URI:n per anslutningsapp antingen via inställningen på fliken Säkerhet eller CLI-verktyget tar du bort den globala omdirigerings-URI:n från dina OAuth 2.0-appar. Du bör lägga till den nyligen genererade unika omdirigerings-URL:en i dina OAuth 2.0-appar.
  • Vi kommer att tillämpa den här uppdateringen för befintliga OAuth anpassade 2.0-anslutningsappar från och med den 17 februari 2024. Alla anpassade anslutningsappar som inte har uppdaterats för att använda en omdirigerings-URI per anslutningsapp slutar fungera för nya anslutningar och visar ett felmeddelande för användaren.
  • Om du vill ta reda på vilka anpassade anslutningsprogram som behöver en uppdatering för att migrera till omdirigerings-URL:en per anslutningsprogram kan du skapa ett flöde som använder åtgärden Hämta anpassade anslutningsprogram som administratör Power Apps för Admin-anslutningsprogrammet och parsa resultatet. Flödet som bifogas senare i den här artikeln hämtar alla anpassade anslutningsprogram med samma. Den tillämpar sedan ett filtervillkor på anslutningsparameterns egenskap för att filtrera bort icke-Oauth anpassat anslutningsprogram, följt av ett annat filter för att endast välja anslutningsappar som inte använder den unika omdirigerings-URL:en per anslutningsapp. Slutligen placerar den de valda anpassade anslutningsprogrammen i en matrisvariabel som initierats i början av flödet och genererar en HTML-tabell som visar namn och skapare av dessa anslutningsprogram. Du kan importera det här flödet till din miljö genom att importera den här lösningen. Du kan utöka flödet ytterligare för att skicka HTML-tabellen som ett e-postmeddelande till dig själv. Eller så kan du utöka den för att skicka e-postmeddelanden direkt till skaparna av anslutningsprogram och ge dem namnen på anslutningsprogrammet som behöver uppdateras.

3. Beskriv API:et och definiera det anpassade kopplingen

När du har ett API med autentiserad åtkomst är nästa sak att göra att beskriva ditt API så att Logic Apps, Power Automate, Power Apps, eller Copilot Studio kan kommunicera med ditt API. Följande metoder stöds:

OpenAPI-definitioner och Postman-samlingar använder olika format, men båda är språkagnostiska, maskinläsbara dokument som beskriver ditt API. Du kan generera dessa dokument från olika verktyg baserat på det språk och den plattform som används av ditt API. I bakgrunden används Logic Apps, Power Automate, Power Appsoch Copilot Studio används OpenAPI för att definiera anslutningsappar.

4. Använd din anslutningsapp i Copilot Studio, Logic Apps Power Automate eller en Power Apps app

Anpassade anslutningsprogram används på samma sätt som förbyggda anslutningsprogram. Du måste skapa en anslutning till ditt API om du vill använda den anslutningen för att anropa åtgärder som du har exponerat i ditt anpassade anslutningsprogram.

Kopplingar som skapats i Power Automate är tillgängliga i Power Apps och Copilot Studio, och kopplingar som skapats i Power Apps är tillgängliga i Power Automate och Copilot Studio. Den här tillgängligheten gäller inte för anslutningsappar som skapats i Logic Apps. Du kan emellertid återanvända OpenAPI-definitionen eller Postman-samlingen för att återskapa anslutningsprogrammet i någon av dessa respektive tjänster. Mer information finns i lämplig självstudie.

Tips!

Om du uppdaterar (tar bort, lägger till eller ändrar) ett fält i API:et utför du följande steg:

  1. Publicera om anslutningsappen så att den tittar på den uppdaterade Swaggern för API:et.
  2. Ta bort alla anslutningar/datakällor i alla appar som använde den kopplingen.
  3. Lägg till anslutningen/datakällan för anslutningsappen igen i apparna.

5. Dela din koppling

Du kan dela din anslutningsapp med användare i din organisation på samma sätt som du delar resurser i Copilot Studio, Logic Apps, Power Automate eller Power Apps. Dela är valfritt men det finnas situationer där du vill dela dina kopplingar med andra användare.

Läs mer i Dela anpassade anslutningsprogram i din organisation.

6. Certifiera din kontakt

Om du vill dela din anslutningsapp med alla användare av Copilot Studio Logic Apps Power Automate och Power Apps måste du skicka in din anslutningsapp för Microsoft-certifiering. Microsoft granskar din anslutningsprogram, kontrollerar teknisk och innehållsmässig efterlevnad och validerar funktionalitet.

Support för Virtual Network

När anslutningsappen används i en Power Platform miljö som är länkad till en Virtual Network gäller begränsningar:

  • När anpassad kod används förklaras begränsningarna i Skriva kod i en anpassad anslutningsapp.

  • Anpassade anslutningsappar som skapades innan miljön kopplades till en Virtual Network måste göras om.

  • Utlösare som returnerar platsrubrik som inte anropar tillbaka till den anpassade anslutningsappen stöds inte.

Ge feedback

Vi uppskattar feedback på problem med vår anslutningsplattform eller nya funktioner. Om du vill ge feedback går du till Skicka problem eller får hjälp med anslutningsprogram och väljer din feedbacktyp.

  • Last updated on