In diesem Tutorial wird veranschaulicht, wie Sie eine Swagger-Datei mithilfe einer Azure Resource Manager (ARM) API registrieren und sie anschließend in PowerApps verbinden.

Voraussetzungen

Aktivieren der Authentifizierung in Azure Active Directory

Zunächst muss eine Azure Active Directory-Anwendung (AAD) erstellt werden, die beim Aufrufen des ARM-API-Endpunkts die Authentifizierung durchführt.

  1. Melden Sie sich beim Azure-Portal an. Wenn Sie über mehr als einen Azure Active Directory-Mandanten verfügen, stellen Sie sicher, dass Sie beim richtigen Verzeichnis angemeldet sind, indem Sie Ihren Benutzernamen in der oberen rechten Ecke überprüfen.

    Benutzername

  2. Klicken Sie im Menü auf der linken Seite auf More services (Weitere Dienste). Geben Sie im Textfeld Filter folgenden Text ein: Azure Active Directory. Klicken Sie anschließend auf Azure Active Directory.

    Azure Active Directory

    Das Azure Active Directory-Blatt wird geöffnet.

  3. Klicken Sie im Menü des Azure Active Directory-Blatts auf App-Registrierungen.

    App-Registrierungen

  4. Klicken Sie in der Liste der registrierten Anwendungen auf Hinzufügen.

    Schaltfläche „Hinzufügen“

  5. Geben Sie einen Namen für Ihre Anwendung ein, lassen Sie die Option Web-App/API ausgewählt, und geben Sie anschließend unter Anmelde-URL Folgendes ein: https://login.windows.net. Klicken Sie auf Erstellen.

    Neues App-Formular

  6. Klicken Sie auf die neue Anwendung in der Liste.

    Neue App in Liste

    Das Blatt „Registrierte App“ wird geöffnet. Notieren Sie sich die Anwendungs-ID. Wir benötigen sie später.

  7. Das Blatt „Einstellungen“ sollte ebenfalls geöffnet sein. Klicken Sie andernfalls auf die Schaltfläche Einstellungen.

    Schaltfläche „Einstellungen“

  8. Klicken Sie auf dem Blatt „Einstellungen“ auf Antwort-URLs. Fügen Sie in der Liste der URLs https://msmanaged-na.consent.azure-apim.net/redirect hinzu, und klicken Sie auf Speichern.

    Antwort-URLs

  9. Klicken Sie auf dem Blatt „Einstellungen“ auf Erforderliche Berechtigungen. Klicken Sie auf dem Blatt „Erforderliche Berechtigungen“ auf Hinzufügen.

    Erforderliche Berechtigungen

    Das Blatt „API-Zugriff hinzufügen“ wird geöffnet.

  10. Klicken Sie auf Hiermit wählen Sie eine API aus. Klicken Sie auf dem Blatt, das geöffnet wird, auf die Option für die Azure-Dienstverwaltungs-API, und klicken Sie anschließend auf Auswählen.

    Auswählen einer API

  11. Klicken Sie auf Berechtigungen auswählen. Klicken Sie unter Delegierte Berechtigungen auf Access Azure Service Management as organization users (Zugriff auf Azure Service Management als Organisationsbenutzer), und klicken Sie anschließend auf Auswählen.

    Delegierte Berechtigungen

  12. Klicken Sie auf dem Blatt „API-Zugriff hinzufügen“ auf Fertig.

  13. Klicken Sie auf dem Blatt „Einstellungen“ auf Schlüssel. Geben Sie auf dem Blatt „Schlüssel“ eine Beschreibung für den Schlüssel ein, wählen Sie ein Ablaufdatum aus, und klicken Sie anschließend auf Speichern. Ihr neuer Schlüssel wird angezeigt. Notieren Sie sich den Schlüsselwert, da wir ihn ebenfalls noch später benötigen. Sie können das Azure-Portal nun schließen.

    Erstellen eines Schlüssels

Hinzufügen der Verbindung in PowerApps

Nachdem die AAD-Anwendung konfiguriert ist, können wir jetzt die benutzerdefinierte API hinzufügen.

  1. Klicken Sie auf powerapps.com im Menü auf der linken Seite auf Connections (Verbindungen). Klicken Sie anschließend in der oberen rechten Ecke auf New connection (Neue Verbindung).

    Tipp:

    Wenn Sie das Menü nicht finden können, ist es in mobilen Browsern möglicherweise unter einer Hamburger-Schaltfläche in der linken oberen Ecke verborgen.

  2. Klicken Sie zum Anzeigen der Liste der benutzerdefinierten Verbindungen auf Custom (Benutzerdefiniert), und klicken Sie anschließend auf Neue benutzerdefinierte API.

    Neue benutzerdefinierte API

  3. Geben Sie einen Namen für Ihre Verbindung ein, und laden Sie anschließend die ARM Swagger-Beispieldatei hoch. Klicken Sie auf Weiter.

    Herstellen einer Verbindung mit einem neuen API-Endpunkt

  4. Auf dem nächsten Bildschirm müssen wir PowerApps einige Informationen über unsere Anwendung geben, da die Swagger-Datei die AAD-Anwendung zur Authentifizierung verwendet. Geben Sie unter Client-ID die AAD Anwendungs-ID ein, die Sie sich zuvor notiert haben. Verwenden Sie als Clientgeheimnis den Schlüssel. Geben Sie abschließend als Ressourcen-URL Folgendes ein: https://management.core.windows.net/.

    Wichtig:

    Achten Sie darauf, dass Sie die Ressourcen-URL genau wie oben beschrieben eingeben, einschließlich des nachgestellten Schrägstrichs.

    OAuth-Einstellungen

  5. Ihre benutzerdefinierte API ist nun registriert und kann in PowerApps oder Microsoft Flow genutzt werden.

    Hinzufügen einer benutzerdefinierten API

Hinweis:

Die Swagger-Beispieldatei legt nicht alle ARM-Vorgänge fest und enthält derzeit nur den Vorgang zum Auflisten aller Abonnements. Sie können diese Swagger-Datei bearbeiten oder eine andere Swagger-Datei mithilfe des Online-Swagger-Editors erstellen.

Dieser Prozess kann verwendet werden, um auf alle RESTful-APIs zuzugreifen, die über AAD authentifiziert werden.

Nächste Schritte

Ausführlichere Informationen zum Erstellen einer App finden Sie unter Generate an app from Excel data (Generieren einer App aus Excel-Daten).

Ausführlichere Informationen zur Verwendung eines Flusses in einer App finden Sie unter Start a flow in an app (Starten eines Flusses in einer App).

Um Fragen zu stellen oder Kommentare über benutzerdefinierte APIs zu posten, treten Sie unserer Community bei.