Del via

Oversikt over egendefinerte koblinger

  • Artikkel

Selv om Azure Logic AppsMicrosoft Power Automate tilbyr Microsoft Power Apps over 1 000 koblinger for å koble til Microsoft og bekreftede tjenester, kan det være lurt å kommunisere med tjenester som ikke er tilgjengelige som forhåndsbygde koblinger. Egendefinerte koblinger løser dette scenarioet ved å la deg opprette (og til og med dele) en kobling med egne utløsere og handlinger.

Skjermbilde som viser hvordan egendefinerte koblinger bygger bro mellom API-en for tekstanalyse og apper.

Livssyklus

Skjermbilde av livssyklusen for egendefinerte koblinger i fem trinn.

1. Bygg API-en din

En egendefinert kobling er en innpakning rundt en REST-API som tillater Logic Apps, Power Automate eller Power Apps å kommunisere med den REST- eller SOAP-API-en. Disse API-ene kan være:

  • Offentlig (synlig på det offentlige internett) som Spotify, Slack, Rackspace eller et API du administrerer.
  • Privat (bare synlig for nettverket ditt).

Logic Apps støtter også SOAP API-er.

For offentlige API-er som du planlegger å opprette og administrere, bør du vurdere å bruke ett av disse produktene Microsoft Azure :

For private API-er tilbyr Microsoft lokal datatilkobling gjennom en lokal datagateway.

2. Sikre API-en din

Bruk en av disse standard godkjenningsmetodene for API-er og koblinger (Microsoft Entra ID anbefales):

Du kan konfigurere Microsoft Entra ID-godkjenning for API-en i Azure-portalen, slik at du ikke trenger å implementere godkjenning. Eller du kan kreve og håndheve autentisering i API-koden din. Hvis du vil ha mer informasjon om Microsoft Entra ID for egendefinerte koblinger, kan du se Sikre API-en og koblingen med Microsoft Entra ID.

2.1. OAuth 2.0

Nyopprettede egendefinerte koblinger som bruker OAuth 2.0 til å godkjenne automatisk, har en URI for omadressering per kobling. Eksisterende OAuth 2.0-koblinger må oppdateres for å bruke en omdirigerings-URI per kobling før 17.

  • Hvis du opprettet de egendefinerte koblingene med webgrensesnittet, redigerer du de egendefinerte koblingene, går til Sikkerhet-fanen og merker av i boksen,Oppdater til unik URL-adresse for omadressering, og lagre deretter for å aktivere URI-en for omdirigering per kobling.
  • Hvis du opprettet egendefinerte koblinger med multigodkjenning ved hjelp av kommandolinjegrensesnittet (CLI), må du oppdatere koblingen ved hjelp av CLI-verktøyet for å angi "redirectMode": "GlobalPerConnector".
  • Når egendefinerte koblinger er oppdatert til å bruke URI-en for omadressering per kobling, enten via innstillingen i kategorien Sikkerhet eller CLI-verktøyet, fjerner du den globale omdirigerings-URI-en fra OAuth 2.0-appene. Du bør legge til den nylig genererte unike nettadressen for viderekobling i 2.0-appene dine OAuth .
  • Vi håndhever denne oppdateringen for eksisterende OAuth egendefinerte 2.0-koblinger fra og med 17. Alle egendefinerte koblinger som ikke er oppdatert for å bruke en omdirigerings-URI per kobling, slutter å fungere for nye tilkoblinger og viser en feilmelding til brukeren.
  • Hvis du vil finne ut hvilke egendefinerte koblinger som trenger en oppdatering for å overføres til URL-adressen for omadressering per kobling, kan du opprette en flyt som bruker handlingen Hent egendefinerte koblinger som administrator for Power Apps for Admin-koblingen og analysere resultatet. Flyten som er vedlagt senere i denne artikkelen, henter alle de egendefinerte koblingene ved hjelp av det samme. Deretter bruker den en filterbetingelse på egenskapen for tilkoblingsparameteren for å filtrere ut egendefinert kobling som ikke er Oauth, etterfulgt av et annet filter for å velge bare koblinger som ikke bruker den unike URL-adressen for omadressering per kobling. Til slutt plasseres de valgte egendefinerte koblingene i en matrisevariabel som initialiseres i begynnelsen av flyten, og genererer en HTML-tabell som viser navn og oppretter av disse koblingene. Du kan importere denne flyten til miljøet ved å importere denne løsningen. Du kan utvide flyten ytterligere for å sende HTML-tabellen som en e-post til deg selv. Eller du kan utvide den til å sende e-postmeldinger direkte til koblingsoppretterne og gi dem navnene på koblingen som må oppdateres.

3. Beskriv API-en og definer den tilpassede koblingen

Når du har et API med autentisert tilgang, er det neste du må gjøre å beskrive API-en din slik at Logic Apps, Power Automate, eller Power Apps kan kommunisere med API-en din. Følgende tilnærminger støttes:

OpenAPI definisjoner og Postman-samlinger bruker forskjellige formater, men begge er språkagnostiske, maskinlesbare dokumenter som beskriver API-en din. Du kan generere disse dokumentene fra ulike verktøy basert på språket og plattformen som brukes av API-en din. Bak kulissene, Logic Apps, Power Automate, og Power Apps bruk OpenAPI til å definere koblinger.

4. Bruk koblingen i en logisk app Power Automate eller Power Apps app

Egendefinerte koblinger brukes på samme måte som forhåndsbygde koblinger brukes. Du må opprette en tilkobling til API-en for å bruke denne tilkoblingen til å kalle opp operasjoner som du eksponerer i den egendefinerte koblingen.

Koblinger opprettet i Power Automate er tilgjengelige i Power Apps, og koblinger opprettet i Power Apps er tilgjengelige i Power Automate. Denne tilgjengeligheten gjelder ikke for koblinger som er opprettet i Logic Apps. Du kan imidlertid bruke definisjonen eller Postman-samlingen OpenAPI på nytt til å opprette koblingen på nytt i en av disse tjenestene. Hvis du vil ha mer informasjon, kan du se den aktuelle opplæringen:

Tips

Hvis du oppdaterer (fjerner, legger til eller endrer) et felt i API-en, utfører du disse trinnene:

  1. Publiser koblingen på nytt slik at den ser på den oppdaterte Swagger for API-en.
  2. Fjern eventuelle tilkoblinger/datakilder i alle apper som brukte denne koblingen.
  3. Legg til tilkoblingen/datakilden for denne koblingen på nytt i appene.

5. Del kontakten din

Du kan dele koblingen med brukere i organisasjonen på samme måte som du deler ressurser i Logic Apps, Power Automate eller Power Apps. Deling er valgfritt, men du kan ha scenarioer der du vil dele koblingene med andre brukere.

Finn ut mer i Dele egendefinerte koblinger i organisasjonen.

6. Sertifiser kontakten din

Hvis du vil dele koblingen med alle brukere av Logic Apps, Power Automate kan Power Apps du sende inn koblingen for Microsoft-sertifisering. Microsoft går gjennom koblingen, ser etter teknisk samsvar og innholdssamsvar og validerer funksjonalitet.

Hvis du vil ha mer informasjon, kan du se Sende koblingene for Microsoft-sertifisering.

Virtual Network-støtte

Når koblingen brukes i et Power Platform miljø som er koblet til et virtuelt nettverk, gjelder begrensninger:

  • Når egendefinert kode brukes, forklares begrensninger i Skrive kode i en egendefinert kobling.

  • Egendefinerte koblinger som ble opprettet før miljøet ble knyttet til et virtuelt nettverk, må lagres på nytt.

  • Utløsere som returnerer lokasjonshode som ikke kaller tilbake til egendefinert kobling, støttes ikke.

gi tilbakemelding

Vi setter stor pris på tilbakemeldinger om problemer med koblingsplattformen vår, eller ideer til nye funksjoner. Hvis du vil gi tilbakemelding, kan du gå til Sende inn problemer eller få hjelp med koblinger og velge tilbakemeldingstype.