Übung – Eine Graph-API aus einem benutzerdefinierten Konnektor verwenden

  • 15 Minuten

In dieser Übung erstellen Sie einen benutzerdefinierten Konnektor und erfahren, wie Sie ihn für den Zugriff auf die Microsoft Graph-API mithilfe der Microsoft Entra ID-Authentifizierung konfigurieren. Da der Schwerpunkt auf der Authentifizierung liegt, wird in dieser Übung nur eine einzelne Aktion mit der Bezeichnung Zuletzt verwendet konfiguriert.

Wichtig

Verwenden Sie eine Testumgebung mit bereitgestelltem Microsoft Dataverse. Wenn Sie keine Testumgebung haben, können Sie sich für den Community-Plan anmelden.

Aufgabe 1: Eine neue Lösung erstellen

Gehen Sie wie folgt vor, um eine neue Lösung zu erstellen:

  1. Navigieren Sie zum Power Apps Maker Portal, und stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden.

  2. Wählen Sie Lösungen > + Neue Lösung aus.

  3. Geben Sie Contoso-Graph für Anzeigename ein, wählen Sie CDS Default Publisher für Herausgeber und dann Erstellen aus. Hinweis: Wenn Sie mit einem realen Projekt arbeiten, erstellen Sie am besten Ihren eigenen benutzerdefinierten Herausgeber.

    Screenshot des Fensters „Neue Lösung erstellen“

  4. Navigieren Sie nach der Auswahl von Erstellen nicht von dieser Seite weg.

Aufgabe 2: Den Graph-Tester zum Testen der API verwenden

In dieser Aufgabe verwenden Sie den Graph-Tester, um eine API-Aktion auszuführen, die Sie im benutzerdefinierten Konnektor konfigurieren.

  1. Navigieren Sie in einer neuen Browserregisterkarte zu Graph-Tester.

  2. Wählen Sie Anmelden aus.

    Screenshot der Anmeldung bei der Schaltfläche „Graph-Tester“

  3. Melden Sie sich mit Ihren Benutzerinformationen an.

  4. Lesen Sie sich die erforderlichen Berechtigungen durch, und fahren Sie dann fort, wenn Sie zustimmen.

  5. Stellen Sie sicher, dass GET für das Verb ausgewählt ist. Fügen Sie /insights/used der URL hinzu, und wählen Sie dann Abfrage ausführen aus.

    Screenshot des Menüs „Get“, der URL und der Schaltfläche „Abfrage ausführen“

  6. Sie sollten den Fehler 403 erhalten, der angibt, dass dem Graph-Tester Ihre Berechtigung zum Ausführen dieser Aktion fehlt.

  7. Wählen Sie die Registerkarte Berechtigungen ändern aus, um dem Graph-Tester die Berechtigung zu erteilen.

  8. Wählen Sie für Sites.Read.AllEinwilligung aus.

  9. Lesen Sie sich die erforderlichen Berechtigungen durch, und fahren Sie dann fort, wenn Sie zustimmen.

  10. Wählen Sie erneut Abfrage ausführen aus.

    Sie sollten nun den Status OK – 200 erhalten

    Screenshot der Vorschau zur Abfrageantwort

  11. Öffnen Sie eine neue Registerkarte für die Browsersitzung.

  12. Navigieren Sie zu Persönlicher Cloudspeicher auf OneDrive, und melden Sie sich an.

  13. Wählen Sie + Neu und Word-Dokument aus. Sie erstellen dieses Dokument so, dass Sie Inhalte in Ihrer Liste Zuletzt verwendet haben.

    Screenshot der Schaltfläche „Neues Word-Dokument erstellen“

  14. Geben Sie einen Testtext in die Word-Datei ein. Das Dokument wird automatisch für Sie gespeichert.

  15. Kehren Sie zum Graph-Tester zurück.

  16. Führen Sie dieselbe Abfrage erneut aus.

    Sie sollten jetzt eine Antwort mit Werten erhalten. Wenn Ihnen keine Antwort angezeigt wird, kehren Sie zu dem Dokument zurück, das Sie in OneDrive erstellt haben, und nehmen Sie Änderungen vor. Wechseln Sie dann wieder zurück ,und führen Sie die Abfrage erneut aus.

  17. Wählen Sie die Antwort JSON aus, klicken Sie mit der rechten Maustaste, und wählen Sie Kopieren aus, und speichern Sie sie dann.

    Screenshot der ausgewählten JSON-Antwort mit der Funktion „Kopieren“

    Sie benötigen diese Antwort später in dieser Übung, da Sie sie verwenden, wenn Sie die Antwort im benutzerdefinierten Konnektor konfigurieren.

Aufgabe 3: Eine neue Anwendung registrieren und Berechtigungen hinzufügen

In dieser Aufgabe konfigurieren Sie eine neue Anwendung, mit der Sie über den benutzerdefinierten Konnektor auf die Graph-API zugreifen können. Sie konfigurieren auch Berechtigungen für die spezifischen Graph-API-Aktionen, ähnlich wie beim Ändern der Berechtigungen im Graph-Tester.

  1. Wechseln Sie zu Microsoft Azure, und melden Sie sich mit Ihren Administratorbenutzer-Anmedeinformationen an.

  2. Wählen Sie Portalmenü anzeigen und dann Microsoft Entra ID aus.

    Screenshot der Microsoft Entra ID-Navigationsschaltfläche

  3. Wählen Sie App-Registrierung > + Neue Registrierung aus.

    Screenshot der Schaltfläche „Neue Anwendungsregistrierung erstellen“

  4. Geben Sie Zuletzt verwendeten Konnektor für Name ein, wählen Sie Web aus, und geben Sie https://global.consent.azure-apim.net/redirect für Umleitungs-URI ein, und wählen Sie dann Registrieren aus.

    Screenshot des Fensters „Eine Anwendung registrieren“

  5. Wählen Sie API-Berechtigungen und dann + Berechtigung hinzufügen aus.

  6. Wählen Sie Microsoft Graph aus.

  7. Wählen Sie Delegierte Berechtigungen aus.

  8. Suchen Sie nach Websites, und erweitern Sie Websites.

  9. Wählen Sie Sites.Read.All, Sites.ReadWrite.All und dann Berechtigungen hinzufügen aus.

    Screenshot des ausgewählten Fensters „Berechtigungen“

  10. Sie sollten nun über drei API-Berechtigungen verfügen. Wählen Sie Zertifikate und Geheimnisse aus.

    Screenshot des Menüs „“Zertifikate und Geheimnisse“ mit drei API-Berechtigungen

  11. Wählen Sie + Neuer geheimer Clientschlüssel aus.

    Screenshot der Schaltfläche „Neuer geheimer Clientschlüssel“

  12. Geben Sie die Aktion des Konnektors Zuletzt verwendet für Beschreibung ein, wählen Sie 90 Tage für Läuft ab und dann Hinzufügen aus.

  13. Kopieren Sie den Wert, und speichern Sie ihn für später, da er nicht erneut angezeigt wird. Sie verwenden diesen geheimen Benutzerschlüssel beim Erstellen des Konnektors.

    Screenshot des Fensters „Geheimer Clientschlüssel“

  14. Wählen Sie Übersicht aus.

  15. Kopieren Sie die Anwendungs-ID (Client), und speichern Sie sie in einem Editor. Sie verwenden diese Client-ID beim Erstellen des Konnektors.

    Screenshot der Anwendungs-ID (Client) mit der Funktion „Kopieren“

Aufgabe 4: Einem benutzerdefinierten Konnektor erstellen

Befolgen Sie diese Schritte, um einen benutzerdefinierten Konnektor zu erstellen:

  1. Navigieren Sie zum Power Apps-Administratorportal, und stellen Sie sicher, dass Sie sich in der richtigen Umgebung befinden.

  2. Wählen Sie Lösungen aus, und öffnen Sie dann die Lösung Contoso-Diagramm, die Sie in Aufgabe 1: Eine neue Lösung erstellen erstellt haben.

  3. Wählen Sie + Neu > Automatisierung > Benutzerdefinierter Konnektor aus.

    Screenshot des Menüs „Neu“ mit ausgewähltem benutzerdefinierten Konnektor

  4. Geben Sie Contoso-Diagramm für Konnektorname ein.

    Screenshot des Contoso-Diagramms, das als Konnektorname eingegeben wurde

  5. Scrollen Sie nach unten, geben Sie graph.microsoft.com für Host und /v1.0 für Basis-URL ein.

  6. Wählen Sie Sicherheit aus.

    Screenshot der Felder „Host“ und „Basis-URL“ mit der Schaltfläche „Sicherheit“

  7. Wählen Sie OAuth 2.0 für Authentifizierung ein.

  8. Wählen Sie Microsoft Entra ID für Identitätsanbieter aus.

  9. Fügen Sie die ID, die Sie aus Azure kopiert haben, in das Feld Client-ID und dann den Wert, den Sie aus Azure kopiert haben, in das Feld Geheimer Clientschlüssel ein.

  10. Geben Sie https://graph.microsoft.com für Ressourcen-URL ein, und wählen Sie dann Konnektor erstellen aus.

    Screenshot der Schaltfläche „Konnektor erstellen“

  11. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 5: Die Aktion hinzufügen

In dieser Aufgabe konfigurieren Sie den zuletzt verwendeten Aktionstipp namens Graph-API.

  1. Wählen Sie Definition > + Neue Aktion aus.

    Screenshot der Schaltfläche „Neue Aktion“ im Fenster „Definition“

  2. Geben Sie Zuletzt verwendet für Zusammenfassung und LastUsed für Vorgangs-ID ein.

  3. Navigieren Sie zum Abschnitt Anforderung, und wählen Sie + Aus Beispiel importieren aus.

    Screenshot der Schaltfläche „Aus Beispiel importieren“ im Abschnitt „Anforderung“

  4. Wählen Sie Get für das Verb aus, geben Sie /me/insights/used für URL ein, und wählen Sie dann Importieren aus.

  5. Scrollen Sie nach unten, und wählen Sie die Standardantwort aus.

    Screenshot der Standardantwort im Abschnitt „Antwort“

  6. Wählen Sie + Aus Beispiel importieren aus.

    Screenshot der Schaltfläche „Aus Beispiel importieren“

  7. Fügen Sie die Antwort, die Sie aus dem Graph-Tester kopiert haben, in das Feld Text ein, und wählen Sie dann Importieren aus.

    Screenshot der Antwort im Feld „Text“ und der Schaltfläche „Importieren“

  8. Wählen Sie Konnektor aktualisieren aus.

  9. Navigieren Sie nicht von dieser Seite weg.

Aufgabe 6: Konnektor testen

Gehen Sie folgendermaßen vor, um den Konnektor zu testen:

  1. Wählen Sie die Registerkarte Testen und dann + Neue Verbindung aus.

    Screenshot der Schaltfläche „Neue Verbindung“ auf der Seite „Testen“

  2. Geben Sie Ihre Anmeldeinformationen ein.

  3. Lesen Sie sich die erforderlichen Berechtigungen durch, und fahren Sie fort.

  4. Wählen Sie Verbindungen aktualisieren aus.

  5. Wählen Sie Vorgang testen aus.

    Screenshot mit hervorgehobener Schaltfläche „Vorgang testen“

    Ihnen sollte der Status 200 angezeigt werden, und die Antwort sollte dem folgenden Bild ähneln.

    Screenshot des Status 200 und des Antwortbeispiels