Använd Azure Active Directory med en anpassad anslutningsapp i PowerAppsUse Azure Active Directory with a custom connector in PowerApps

Med Azure Resource Manager (ARM) kan du hantera komponenterna i en lösning på Azure-komponenter som databaser, virtuella datorer och webbappar.Azure Resource Manager (ARM) enables you to manage the components of a solution on Azure - components like databases, virtual machines, and web apps. Den här kursen visar hur du aktiverar autentisering i Azure Active Directory, registrerar ett av ARM-API: erna som en anpassad anslutningsapp och sedan ansluter till den i PowerApps.This tutorial demonstrates how to enable authentication in Azure Active Directory, register one of the ARM APIs as a custom connector, then connect to it in PowerApps. Det är bra om du vill hantera Azure-resurser direkt från en app.This would be useful if you want to manage Azure resources directly from an app. Mer information om ARM finns i Översikt över Azure Resource Manager.For more information about ARM, see Azure Resource Manager Overview.

FörutsättningarPrerequisites

Aktivera Azure Active Directory-autentiseringEnable authentication in Azure Active Directory

Vi måste först skapa ett program i Azure Active Directory (AAD) som utför autentiseringen vid anrop till en ARM-API-slutpunkt.First, we need to create an Azure Active Directory (AAD) application that will perform the authentication when calling the ARM API endpoint.

  1. Logga in på Azure Portal.Sign in to the Azure portal. Om du har fler än en Azure Active Directory-klient måste du kontrollera att du är inloggad i rätt katalog genom att titta på ditt användarnamn i det övre högra hörnet.If you have more than one Azure Active Directory tenant, make sure you're logged into the correct directory by looking at your username in the upper-right corner.

    Användarnamn

  2. Klicka på menyn Fler tjänster till vänster.On the left-hand menu, click More services. Skriv Azure Active Directory i textrutan Filter och klicka sedan på Azure Active Directory.In the Filter textbox, type Azure Active Directory, and then click Azure Active Directory.

    Azure Active Directory

    Bladet Azure Active Directory öppnas.The Azure Active Directory blade opens.

  3. I menyn på Azure Active Directory-bladet klickar du på App-registreringar.In the menu on the Azure Active Directory blade, click App registrations.

    App-registreringar

  4. Klicka på Lägg till i listan över registrerade program.In the list of registered applications, click Add.

    Lägg till knapp

  5. Skriv ett namn för programmet, lämna Webapp/API markerad och skriv https://login.windows.net i Inloggnings-URL.Type a name for your application, leave Web app / API selected, and then for Sign-on URL type https://login.windows.net. Klicka på Skapa.Click Create.

    Nytt programformulär

  6. Klicka på det nya programmet i listan.Click the new application in the list.

    Ny app i listan

    Bladet registrerad app öppnas.The Registered app blade opens. Anteckna Program-ID.Make a note of the Application ID. Vi kommer att behöva det senare.We'll need it later.

  7. Bladet inställningar bör också vara öppet.The Settings blade should have opened, as well. Om det inte är öppet, klickar du på knappen Inställningar.If it didn't, click the Settings button.

    Knappen inställningar

  8. På bladet inställningar klickar du på Svars-URL.In the Settings blade, click Reply URLs. Lägg till i listan över URL: er https://msmanaged-na.consent.azure-apim.net/redirect och klicka på spara.In the list of URLs, add https://msmanaged-na.consent.azure-apim.net/redirect and click Save.

    Svars-URL

  9. När du är tillbaka på bladet inställningar klickar du på Behörigheter som krävs.Back on the Settings blade, click Required permissions. Klicka på Lägg till på bladet Behörigheter som krävs.On the Required permissions blade, click Add.

    Behörigheter som krävs

    Bladet lägg till API-åtkomst öppnas.The Add API access blade opens.

  10. Klicka på Välj en API.Click Select an API. I bladet som öppnas klickar du på alternativet för Azure Service Management-API och Välj.In the blade that opens, click the option for the Azure Service Management API and click Select.

    Välj ett API

  11. Klicka på Välja behörigheter.Click Select permissions. Under Delegerade behörigheter, klickar du på Åtkomst till Azure Service Manager som organisationsanvändare och klicka sedan på Välj.Under Delegated permissions, click Access Azure Service Management as organization users, and then click Select.

    Delegerade behörigheter

  12. Klicka på Klar på bladet Lägg till API-åtkomst.On the Add API access blade, click Done.
  13. På bladet inställningar klickar du på Nycklar.Back on the Settings blade, click Keys. Ange en beskrivning av nyckeln på bladet nycklar och välj en förfalloperiod. Klicka sedan på Spara.In the Keys blade, type a description for your key, select an expiration period, and then click Save. Den nya nyckeln visas.Your new key will be displayed. Anteckna värdet för nyckeln, som vi kommer att behöva som senare.Make note of the key value, as we will need that later, too. Nu kan du stänga Azure-portalen.You may now close the Azure portal.

    Skapa en nyckel

Lägg till anslutningen i PowerAppsAdd the connection in PowerApps

Nu när AAD-programmet har konfigurerats är det dags att lägga till en anpassad anslutningsapp.Now that the AAD application is configured, let's add the custom connector.

  1. I den vänstra menyn på powerapps.com klickar du på Anslutningar.In powerapps.com, in the left menu, select Connections. Välj knappen med tre punkter (...) och välj sedan Hantera anpassade anslutningsappar i det övre högra hörnet.Select the ellipsis (...), then select Manage custom connectors in the upper right corner.

    Tips: Om du inte hittar var du hanterar anpassade anslutningsappar i en mobil webbläsare kan det vara under en meny i det övre vänstra hörnet.Tip: If you can't find where to manage custom connectors in a mobile browser, it might be under a menu in the upper left corner.

    Skapa en anpassad anslutningsapp

  2. Välj Skapa anpassad anslutningsapp.Select Create custom connector.

    Egenskaper för anpassad anslutningsapp

  3. Ange ett namn för anslutningen och överför sedan exempelfilen ARM OpenAPI.Type a name for your connection, and then upload the sample ARM OpenAPI file. Klicka på Fortsätt.Click Continue.

    Anslut till en ny API-slutpunkt

  4. Eftersom filen OpenAPI använder AAD-programmet för autentisering behöver vi ge PowerApps viss information om vårt program på nästa skärm.On the next screen, because the OpenAPI file uses our AAD application for authentication, we need to give PowerApps some information about our application. Skriv det AAD-program-ID du antecknade tidigare under Klient-id.Under Client id, type the AAD Application ID you noted earlier. Använd nyckeln för klientsekretess.For client secret, use the key. Ange slutligen https://management.core.windows.net/ för Resurs-URL.And finally, for Resource URL, type https://management.core.windows.net/.

    Viktigt:Se till att inkludera resurs-URL: en exakt likadant som ovan, inklusive avslutande snedstreck.Important: Be sure to include the Resource URL exactly as written above, including the trailing slash.

    OAuth-inställningar

  5. Din anpassade anslutningsapp är nu registrerad och kan användas i PowerApps eller Microsoft Flow.Your custom connector is now registered and can be consumed within PowerApps or Microsoft Flow.

    Anpassad anslutningsapp som lagts till

    OBS: OpenAPI-exemplet definierar inte samtliga ARM-åtgärder och innehåller för tillfället endast åtgärden Skapa lista över alla prenumerationer.Note: The sample OpenAPI does not define the full set of ARM operations and currently only contains the List all subscriptions operation. Du kan redigera OpenAPI-filen eller skapa en annan OpenAPI-fil med OpenAPI-redigeraren online.You can edit this OpenAPI file or create another OpenAPI file using the online OpenAPI editor. Den här processen kan användas för att få åtkomst till valfri RESTful-API som autentiserats med AAD.This process can be used to access any RESTful API authenticated using AAD.

Nästa stegNext steps

Mer detaljerad information om hur du skapar en app finns Skapa en app från data.For more detailed information about how to create an app, see Create an app from data.

Mer detaljerad information om hur du använder ett flöde i en app finns i Starta ett flöde i en app.For more detailed information about how to use a flow in an app, see Start a flow in an app.

Du kan ställa frågor eller skriva kommentarer om anpassade anslutningsappar om du går med i vår community.To ask questions or make comments about custom connectors, join our community.