Dela via

Autentisera ditt API och anslutning med Microsoft Entra ID

Med Azure Resource Manager kan du hantera komponenterna i en lösning i Azure – komponenter som databaser, virtuella datorer och webbappar. Den här självstudiekursen visar hur du aktiverar autentisering i Microsoft Entra ID, registrerar ett av Resource Manager-API:erna som en anpassad koppling och sedan ansluter den i Power Automate. Du kan också skapa den anpassade anslutningsappen för Power Apps eller Azure Logic Apps, eller skapa en anpassad AI-aktiverad anslutningsapp för Microsoft Copilot Studio.

Den process du följer i dessa självstudier kan användas för att få åtkomst till en RESTful-API som autentiseras med hjälp av Microsoft Entra ID.

Förutsättningar

Aktivera autentisering i Microsoft Entra ID

Först skapar du ett Microsoft Entra ID-program som utför autentiseringen när du anropar API-slutpunkten för resurshanterare.

  1. Logga in på Azure-portal. Om du har fler än en Microsoft Entra ID-klientorganisation måste du kontrollera att du är inloggad i rätt katalog genom att verifiera att ditt användarnamn visas i det övre högra hörnet.

    Skärmbild av användarnamnet som visas i Azure-portalen.

  2. I den vänstra rutan väljer du Alla tjänster. I rutan Filter anger du Azure Active Directory och väljer Azure Active Directory sedan.

    Skärmbild av Azure Active Directory i tjänstlistan.

    Bladet Azure Active Directory öppnas.

  3. I den vänstra rutan på Azure Active Directory bladet väljer du Appregistreringar.

  4. I listan över registrerade program väljer du Ny programregistrering.

  5. Ange ett namn för ditt program och lämna Programtyp som webbapp/API.

    Skärmbild av det nya registreringsformuläret för program.

  6. Kopiera program-ID:t eftersom du behöver det senare.

  7. I den vänstra rutan på bladet Hantera väljer du API-behörigheter. Välj sedan Lägg till en behörighet.

    Skärmbild av sidan API-behörigheter.

    Bladet Begär API-behörigheter öppnas.

  8. Under Delegerade behörigheter väljer du Åtkomst till Azure Service Management som organisationsanvändare>Välj.

    Skärmbild av val av delegerade behörigheter.

  9. På bladet Lägg till API-åtkomst väljer du Lägg till behörigheter.

  10. Gå tillbaka till bladet Hantera , välj Certifikat och hemligheter och välj Ny klienthemlighet, ange en beskrivning för din hemlighet, välj en förfalloperiod och välj sedan Spara.

  11. Din nya hemlighet visas. Kopiera det hemliga värdet eftersom du behöver det senare och det kan inte hämtas när du har navigerat bort för den här sidan.

    Skärmbild av formuläret för att skapa klienthemligheter.

Det finns ytterligare ett steg för att slutföra i Azure-portalen, men du ska först skapa en egen koppling.

Skapa ett anpassat anslutningsprogram

Nu när Microsoft Entra ID-appen har konfigurerats skapar du det anpassade anslutningsprogrammet.

  1. Power Automate I webbappen väljer du Inställningar (kugghjulsikonen) i det övre högra hörnet på sidan och väljer sedan Anpassade anslutningsappar.

  2. Välj Skapa anpassad anslutningsapp>Importera en OpenAPI fil.

  3. Ange ett namn för anslutningsappen, bläddra till exempelfilen OpenAPI och välj sedan Fortsätt.

    Skärmbild av fälten för anslutningsappens namn och filplats.

  4. Sidan Allmänt öppnas. Lämna standardvärdena som de visas och välj sedan sidan Säkerhet .

  5. På sidan Säkerhet anger du Microsoft Entra ID-information för programmet:

    • Under Klient-ID anger du det ID-program-ID-värde som Microsoft Entra du kopierade tidigare.

    • För Klienthemlighet använder du det värde som du kopierade tidigare.

    • För Resurs-URL anger du https://management.core.windows.net/. Var noga med att inkludera resurs-URL:en exakt så som den har skrivits ned ovan, inklusive avslutande snedstreck.

    Skärmbild av konfiguration av OAuth-inställningar.

    När du har angett säkerhetsinformation markerar du bockmarkeringen (✓) bredvid flödesnamnet överst på sidan för att skapa den anpassade anslutningsappen.

  6. På sidan Säkerhetär fältet Omdirigerings-URL nu ifyllt. Kopiera URL:en så att du kan använda den i nästa avsnitt i självstudien.

  7. Ditt anpassade anslutningsprogram visas nu under Anpassade anslutningsprogram.

    Skärmbild av tillgängliga API:er.

  8. Nu när den anpassade anslutningen har registrerats måste du skapa en anslutning till den anpassade anslutningen så att det kan användas i dina appar och flöden. Välj plustecknet (+) till höger om namnet på din anpassade anslutningsapp och slutför sedan inloggningsskärmen.

Obs

Exemplet OpenAPI definierar inte den fullständiga uppsättningen Resource Manager-åtgärder, utan innehåller för närvarande bara åtgärden Lista alla prenumerationer . Du kan redigera den här OpenAPI filen eller skapa en annan OpenAPI fil med hjälp av onlineredigeraren OpenAPI .

Ange svars-URL i Azure

Välj Azure Active Directory (Microsoft Entra ID) och välj sedan din app. Välj Autentisering på den vänstra menyn och välj sedan Lägg till URI. Lägg till det värde som du kopierade från fältet Omdirigerings-URI i det anpassade anslutningsprogrammet, till exempel, https://global.consent.azure-apim.net/redirect/samplecustomconnector123-5f98284236d845b802-5f21c6202f06d65e16 och välj sedan Spara.

Skärmbild av att lägga till omdirigerings-URI-värde i en anpassad anslutning.

Hanterad identitetsautentisering (förhandsversion)

Anpassade anslutningsappar stöder nu användning av en hanterad identitet i stället för att använda klienthemligheten för entra-användardelegeringsautentisering. På så sätt behöver du inte bry dig om att rotera klienthemligheterna när de närmar sig sin utgång. Observera att det här är en förhandsversionsfunktion som fortfarande distribueras. Du kanske inte ser det här alternativet i dina anpassade anslutningar. Det är också viktigt att observera att den här funktionen kräver att klientprogrammet är en singeltenantapplikation.

  1. På fliken Säkerhet i den anpassade anslutningsappen väljer du Autentiseringstyp som OAuth 2.0 och Identitetsprovider som Azure Active Directory och väljer sedan alternativknappen för hanterad identitet. Observera att abonnent-ID:t i det här fallet måste vara ett verkligt abonnent-ID Guid. Att använda common fungerar inte.

    Skärmbild av alternativet för autentisering av hanterad identitet.

  2. När du har sparat kopplingen kan de hanterade identitetssträngarna kopieras längst ned på säkerhetssidan eller sidan med kopplingsinformation.

    Skärmbild av informationssidan.

  3. Du måste lägga till den här hanterade identiteten som skapats för den anpassade anslutningen i din Klient-Entra-app. Under avsnittet Certifikat och hemligheter väljer du fliken Federerade autentiseringsuppgifter .

    Skärmbild av listan över autentiseringsuppgifter.

  4. Lägg till en ny autentiseringsuppgift.

    Skärmbild av hur du lägger till en autentiseringsuppgift.

    Kopiera och klistra in utfärdarens och ämnesidentifierarens strängar som hämtats från fältet Hanterad identitet på sidan med anpassad anslutningsinformation eller på säkerhetsfliken på redigeringssidan.

    Skärmbild av ämnes- och utfärdarens ID-strängar.

  5. När du har lagt till den här hanterade identiteten i appen kan du framgångsrikt skapa anslutningar till din anslutare. Det här är också en engångskonfiguration och precis som omdirigerings-URL:en ändras inte den hanterade identitetsinformationen om du uppdaterar anslutningsappen. Om du exporterar och importerar anslutningsappen till en annan miljö genereras dessutom en ny hanterad identitet för den anslutningsappen som måste läggas till i respektive Entra-app.

Använd anpassade anslutningsappar i Power Automate.

Om du vill ställa frågor eller kommentera anpassade anslutningar kan du gå med i vår community.

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.