Den här kursen visar hur du registrerar en Swagger-fil som beskriver en Azure Resource Manager (ARM) API och sedan ansluter den i PowerApps.

Förutsättningar

Aktivera Azure Active Directory-autentisering

Vi måste först skapa ett program i Azure Active Directory (AAD) som utför autentiseringen vid anrop till en ARM-API-slutpunkt.

  1. Logga in på 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.

    Användarnamn

  2. Klicka på menyn Fler tjänster till vänster. Skriv Azure Active Directory i textrutan Filter och klicka sedan på Azure Active Directory.

    Azure Active Directory

    Bladet Azure Active Directory öppnas.

  3. I menyn på Azure Active Directory-bladet klickar du på App-registreringar.

    App-registreringar

  4. Klicka på Lägg till i listan över registrerade program.

    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. Klicka på Skapa.

    Nytt programformulär

  6. Klicka på det nya programmet i listan.

    Ny app i listan

    Bladet registrerad app öppnas. Anteckna Program-ID. Vi kommer att behöva det senare.

  7. Bladet inställningar bör också vara öppet. Om det inte är öppet, klickar du på knappen Inställningar.

    Knappen inställningar

  8. På bladet inställningar klickar du på Svars-URL. Lägg till i listan över URL: er https://msmanaged-na.consent.azure-apim.net/redirect och klicka på spara.

    Svars-URL

  9. När du är tillbaka på bladet inställningar klickar du på Behörigheter som krävs. Klicka på Lägg till på bladet Behörigheter som krävs.

    Behörigheter som krävs

    Bladet lägg till API-åtkomst öppnas.

  10. Klicka på Välj en API. I bladet som öppnas klickar du på alternativet för Azure Service Management-API och Välj.

    Välj ett API

  11. Klicka på Välja behörigheter. Under Delegerade behörigheter, klickar du på Åtkomst till Azure Service Manager som organisationsanvändare och klicka sedan på Välj.

    Delegerade behörigheter

  12. Klicka på Klar på bladet Lägg till API-åtkomst.

  13. På bladet inställningar klickar du på Nycklar. Ange en beskrivning av nyckeln på bladet nycklar och välj en förfalloperiod. Klicka sedan på Spara. Den nya nyckeln visas. Anteckna värdet för nyckeln, som vi kommer att behöva som senare. Nu kan du stänga Azure-portalen.

    Skapa en nyckel

Lägg till anslutningen i PowerApps

Nu när AAD-programmet har konfigurerats är det dags att lägga till ett anpassat API.

  1. I menyn till vänster på powerapps.com klickar du på Connections. Klicka på Ny anslutning i det övre högra hörnet.

    Tip:

    Om du inte hittar menyn kan den vara under ikonen med tre vågräta streck i mobilwebbläsarens övre vänstra hörn.

  2. Klicka på Anpassa för att visa listan över anpassade anslutningar och sedan på Nytt anpassat API.

    Nytt anpassat API

  3. Ange en Namn för anslutningen och överför sedan exempelfilen ARM Swagger. Klicka på Next.

    Anslut till en ny API-slutpunkt

  4. Eftersom filen Swagger använder våra AAD-programmet för autentisering, som vi behöver ge PowerApps viss information om vårt program på nästa skärm. Skriv det AAD-program-ID du antecknade tidigare under Klient-id. Använd nyckeln för klientsekretess. Ange slutligen https://management.core.windows.net/ för Resurs-URL.

    Important:

    Se till att inkludera resurs URL: en exakt likadant som ovan, inklusive avslutande snedstreck.

    OAuth-inställningar

  5. Ditt anpassade API är nu registrerat och kan användas i PowerApps eller Microsoft Flow.

    Anpassat API har lagts till

Note:

Swagger-exemplet definierar inte samtliga ARM-åtgärder och innehåller för tillfället endast åtgärden Skapa lista över alla prenumerationer. Du kan redigera denna Swagger eller skapa en annan Swagger-fil med Swagger-onlineredigeraren.

Den här processen kan användas för att få åtkomst till valfri RESTful-API som autentiserats med AAD.

Nästa steg

Mer detaljerad information om hur du skapar en app finns Skapa en app från data.

Mer detaljerad information om hur du använder ett flöde i en app finns i Starta ett flöde i en app.

Du kan ställa frågor eller kommentarer om anpassade API:er om du går med i vår community.