Delen via

Overzicht van aangepaste connectors

Hoewel Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps meer dan 1.000 connectoren biedt om verbinding te maken met Microsoft en geverifieerde services, en Microsoft Copilot Studiou deze vooraf gebouwde connectoren kunt gebruiken, wilt u mogelijk communiceren met services die niet beschikbaar zijn als vooraf gebouwde connectoren. Aangepaste connectors helpen bij dit scenario, omdat u een connector kunt maken (en zelfs delen) met eigen triggers en acties.

Schermafbeelding die laat zien hoe aangepaste connectoren de Text Analytics API met apps verbinden.

Levenscyclus

Schermafbeelding van de levenscyclus van aangepaste connectoren in vijf fasen.

1. Bouw uw API

Een aangepaste connector is een wrapper rond een REST API waarmee Logic Apps, Power Automate, Power Apps of Copilot Studio kunnen communiceren met die REST of SOAP API. De volgende API's zijn beschikbaar:

  • Openbaar (zichtbaar op het openbare internet), zoals Spotify, Slack, Rackspace of een API die u beheert.
  • Privé (alleen zichtbaar in uw netwerk).

Logic Apps ondersteunt ook SOAP-API's.

Overweeg een van deze Microsoft Azure-producten te gebruiken voor openbare API's die u wilt maken en beheren:

Voor privé-API's biedt Microsoft on-premises gegevensconnectiviteit via een on-premises gegevensgateway.

2. Beveilig uw API

Gebruik een van deze standaardauthenticatiemethoden voor uw API's en connectoren (Microsoft Entra ID wordt aanbevolen):

U kunt Microsoft Entra ID-verificatie voor uw API instellen in de Azure Portal, zodat u geen verificatie hoeft te implementeren. Of u kunt verificatie vereisen en afdwingen in de code van uw API. Zie Microsoft Entra Uw API en connector beveiligen met ID Microsoft Entra voor meer informatie over ID's voor aangepaste connectoren.

2.1. OAuth 2.0

Nieuw gemaakte aangepaste connectoren die OAuth 2.0 gebruiken voor automatische authenticatie, hebben een omleidings-URI per connector. Bestaande OAuth 2.0-connectoren moeten vóór 17 februari 2024 worden bijgewerkt om een omleidings-URI per connector te gebruiken.

  • Als u uw aangepaste connectoren via de webinterface hebt gemaakt, bewerkt u uw aangepaste connectoren, gaat u naar het tabblad Beveiliging en vinkt u het vakje Bijwerken naar unieke omleidings-URL aan. Sla de connectoren vervolgens op om de omleidings-URI per connector in te schakelen.
  • Als u uw aangepaste connectoren met multi-auth hebt gemaakt met behulp van de opdrachtregelinterface (CLI), moet u uw connector bijwerken met behulp van de CLI-tool om "redirectMode": "GlobalPerConnector" in te stellen.
  • Zodra aangepaste connectoren zijn bijgewerkt om de omleidings-URI per connector te gebruiken, via de instelling op het tabblad Beveiliging of de CLI-tool, verwijdert u de algemene omleidings-URI uit uw OAuth 2.0-apps. Voeg de nieuw gegenereerde unieke omleidings-URL toe aan uw OAuth 2.0-apps.
  • We passen deze update toe voor bestaande 2.0-aangepaste connectoren vanaf 17 februari 2024. OAuth Elke aangepaste connector die niet is bijgewerkt om een omleidings-URI per connector te gebruiken, werkt niet meer voor nieuwe verbindingen en toont een foutmelding aan de gebruiker.
  • Om erachter te komen welke aangepaste connectoren een update nodig hebben om te migreren naar een omleidings-URL per connector, kunt u een stroom maken die de actie Aangepaste connectoren ophalen als beheerder van Power Apps voor de beheerdersconnector gebruikt en het resultaat ervan parseren. De stroom die verderop in dit artikel wordt bijgevoegd, haalt alle aangepaste connectoren daarmee op. Vervolgens wordt een filtervoorwaarde op de eigenschap van de verbindingsparameter toegepast om aangepaste connectoren die niet van OAuth zijn, uit te filteren. Vervolgens wordt een ander filter gebruikt om alleen connectoren te selecteren die geen unieke omleidings-URL per connector gebruiken. Tot slot worden de geselecteerde aangepaste connectoren in een matrixvariabele geplaatst die aan het begin van de stroom is geïnitialiseerd en een HTML-tabel genereert met de naam en maker van die connectoren. U kunt deze stroom importeren in uw omgeving door deze oplossing te importeren . U kunt de stroom verder uitbreiden door de HTML-tabel als e-mail naar uzelf te verzenden. Of u kunt deze uitbreiden om rechtstreeks e-mails naar de makers van de connector te sturen en hen de namen te geven van de connector die moet worden bijgewerkt.

3. Beschrijf de API en definieer de aangepaste connector

Zodra u over een API met geverifieerde toegang beschikt, moet u uw API beschrijven, zodat Logic Apps, Power Automate, Power Apps of Copilot Studio met uw API kunnen communiceren. De volgende benaderingen worden ondersteund:

OpenAPI-definities en Postman-verzamelingen hebben verschillende indelingen, maar zijn beide taalonafhankelijke, machineleesbare documenten waarin uw API wordt beschreven. U kunt deze documenten genereren vanuit verschillende hulpprogramma's, afhankelijk van de taal en het platform dat uw API gebruikt. Achter de schermen gebruiken Logic Apps Power Automate, Power Apps en Copilot Studio OpenAPI connectoren.

4. Gebruik uw connector in Copilot Studio, Logic Apps, Power Automate of een Power Apps app

Aangepaste connectors worden op dezelfde manier gebruikt als vooraf gebouwde connectors. U moet een verbinding maken met uw API om de verbinding te gebruiken om bewerkingen aan te roepen die u in uw aangepaste connector hebt gemaakt.

Connectoren die zijn gemaakt in Power Automate zijn beschikbaar in Power Apps en Copilot Studio, en connectoren die zijn gemaakt in Power Apps zijn beschikbaar in Power Automate en Copilot Studio. Deze beschikbaarheid geldt niet voor connectoren die zijn gemaakt in Logic Apps. U kunt de OpenAPI-definitie of Postman-verzameling echter gebruiken om de connector opnieuw te maken in een van deze services. Voor meer informatie raadpleegt u de bijbehorende zelfstudie:

Tip

Als u een veld in de API wilt bijwerken (verwijderen, toevoegen of wijzigen), voert u de volgende stappen uit:

  1. Publiceer de connector opnieuw, zodat deze naar de bijgewerkte Swagger voor de API kijkt.
  2. Verwijder alle verbindingen/gegevensbronnen in alle apps die deze connector gebruikten.
  3. Voeg de verbinding/gegevensbron voor die connector opnieuw toe aan de apps.

5. Deel uw connector

U kunt uw connector delen met gebruikers in uw organisatie op dezelfde manier als u resources deelt in Copilot Studio, Logic Apps, Power Automate of Power Apps. Delen is optioneel, maar u hebt mogelijk scenario's waarin u uw connectors met andere gebruikers wilt delen.

Meer informatie vindt u in Aangepaste connectoren delen in uw organisatie.

6. Certificeer uw connector

Als u uw connector wilt delen met alle gebruikers van Copilot Studio, Logic Apps, Power Automate en Power Apps, moet u uw connector indienen voor Microsoft-certificering. Microsoft beoordeelt uw connector, controleert op technische naleving en inhoud en valideert de functionaliteit.

Virtual Network-ondersteuning

Wanneer de connector wordt gebruikt in een omgeving die is gekoppeld aan een virtueel netwerk, gelden er beperkingen: Power Platform

  • Wanneer aangepaste code wordt gebruikt, worden de beperkingen uitgelegd in Code schrijven in een aangepaste connector.

  • Aangepaste connectoren die zijn gemaakt voordat de omgeving aan een virtueel netwerk is gekoppeld, moeten opnieuw worden opgeslagen.

  • Triggers die een locatieheader retourneren en geen terugkoppeling naar een aangepaste connector uitvoeren, worden niet ondersteund.

Feedback geven

We stellen feedback over problemen met ons connectorplatform of ideeën voor nieuwe functies zeer op prijs. Als u feedback wilt geven, gaat u naar Problemen indienen of hulp krijgen met connectoren en selecteert u het type feedback.