Versionen im Vergleich
Schlüssel
- Diese Zeile wurde hinzugefügt.
- Diese Zeile wurde entfernt.
- Formatierung wurde geändert.
Status | ||||
---|---|---|---|---|
|
Microsoft Graph ist eine umfangreiche Sammlung verschiedener RESTful-Web-APIs, mit der auf Microsoft Cloud-Dienstressourcen zugegriffen werden kann. Um Microsoft Graph mit der Aktivität “HTTP-Request senden” nutzen zu können, benötigen Sie neben einem Registrierungsschlüssel der Anwendung auch einen geheimen Schlüssel. Wie Sie dabei vorgehen, wurde bereits bei den MS SharePoint Einstellungen beschrieben, Sie können dies jedoch auch direkt in der API-Beschreibung von Microsoft Graph nachlesen.
Endpunkte:
Microsoft Login: https://login.microsoftonline.com/<Verzeichnis-ID>/oauth2/v2.0/token
Microsoft Graph: https://graph.microsoft.com/v1.0
Wie wird authentifiziert? Eigener Login-Endpunkt mit Token
Wo finde ich Hilfe?
Authentifizierung: https://docs.microsoft.com/de-de/graph/auth/
Kalender: https://docs.microsoft.com/de-de/graph/outlook-calendar-concept-overview
Event-Beschreibung: https://docs.microsoft.com/de-de/graph/api/resources/event?view=graph-rest-1.0
Key-Features
Verwenden von Header
Verwenden eines Contents im Format “form-url-encoded”
Verwenden eines durch Login ermittelten Bearer-Tokens
Voraussetzungen
Es liegt ein Microsoft-Konto vor, um Anwendungen zu registrieren und Berechtigungen für die Anwendungen im Azure-Portal vergeben zu können
Es wurde die Anwendung auf dem Azure-Portal registriert
Es wurde ein geheimer Clientschlüssel auf dem Azure-Portal erstellt
Berechtigung für die Anwendung, um auf den Kalender schreibend zugreifen zu können
Inhalt
Inhalt |
---|
WMS: Konfiguration des HTTP-Endpunkts
Um einen Termin in den Outlook-Kalender einzutragen, müssen zwei Endpunkte konfiguriert werden. Mit dem einen Endpunkt wird über einen Login ein Bearer-Token ermittelt, welches dann für den eigentlichen Aufruf zur Terminerstellung im Header mitgegeben werden muss. Mit dem anderen Endpunkt wird dann der Termin im Kalender erstellt.
HTTP-Endpunkt für den Login
Name | Beschreibung |
---|---|
Name | Name für den Endpunkt, z.B. “Microsoft Graph Login“. Aus dem Namen wird eine Zuordnungsvariable erstellt, welche bei der Aktivität verwendet werden muss. |
URL | https://login.microsoftonline.com/<Verzeichnis-ID>/oauth2/v2.0/token Die Verzeichnis-ID ist aus dem Azure-Portal bei der App-Registrierung zu entnehmen |
Authentifizierungsart | Keine |
Header | Im Header müssen folgende Einträge hinzugefügt werden:
|
Content | Alle für die Authentifizierung notwendigen Daten werden als FormUrlEncoded-Content angegeben. Entsprechend können folgende Parameter bereits beim Endpunkt konfiguriert werden:
|
Test der Verbindung
Wurden alle Angaben korrekt eingegeben, kann die Verbindung zum Login-Endpunkt getestet werden. Hierzu muss als HTTP-Methode “POST” angegeben werden, eine relative URL ist nicht notwendig, sofern die vollständige URL bereits wie oben beschrieben angegeben wurde.
Image Added
Image Added
HTTP-Endpunkt für die Graph-API (z.B. zur Termin-Erstellung)
Name | Beschreibung |
---|---|
Name | Name, z.B. “Microsoft Graph” |
URL | https://graph.microsoft.com/v1.0 Dies ist die Basis-Adresse der Microsoft Graph API und muss mit einer relativen URL ergänzt werden. |
Authentifizierungsart | Keine |
Header | Im Header müssen folgende Einträge hinzugefügt werden:
|
Aktivität “Http-Request” 1: Token per Login ermitteln
Fügen Sie Ihrem Workflow nun die Aktivität HTTP-Request senden hinzu. Damit soll zunächst ein Login erfolgen.
Name | Beschreibung | |
---|---|---|
Endpunkt | Variable für den HTTP-Endpunkt (hier: “http_MicrosoftGraphLogin”) aus den Zuordnungen. | |
Relative URL | Es ist keine relative URL erforderlich | |
HTTP-Methode | POST | |
Header | Es sind keine Header erforderlich | |
ContentAlle | Wenn die für die Authentifizierung notwendigen Daten werden als FormUrlEncoded Content angegeben. Dies sind im Folgenden:
bereits beim Endpunkt konfiguriert wurden, brauchen hier keine weiteren FormUrlEncoded-Contents angegeben werden. |
Ergebnis des Logins
Mit dem Senden des Requests wird ein Json-String als Ergebnis zurückgegeben. In dem Json-String befindet sich das “access_token”, welches für die weiteren Aufrufe angegeben werden muss (im Beispiel der Wert “xxx”).
Codeblock | ||
---|---|---|
| ||
{ "token_type": "Bearer", "expires_in": 3599, "ext_expires_in": 3599, "access_token": "xxx" } |
Image Modified
Aktivität “Http-Request” 2: Termin erstellen
Mit einem POST und mit Hilfe des Tokens aus dem Login-Request soll nun ein Termin im Outlook-Kalender eingetragen werden
Name | Beschreibung | ||
---|---|---|---|
Endpunkt | Variable für den HTTP-Endpunkt (hier: “http_MicrosoftGraph”) aus den Zuordnungen. | ||
Relative URL | users/<E-Mailadresse des Senders>/events | ||
HTTP-Methode | POST | ||
Header | Im Header muss das Bearer-Token übergeben werden, welches aus dem Ergebnis des Logins ausgelesen werden kann:
| ||
Content | Im Content werden die Daten für den Kalendereintrag im Json-Format mitUTF-8 übergeben. Details zum Content und den notwendigen Einstellungen finden sich in der Microsoft Graph API-Beschreibung. Daraus ergeben sich folgende Einstellungen:
|
Verwandte Themen
Nach Stichwort filtern (Inhalt nach Stichwort) | ||||||
---|---|---|---|---|---|---|
|
Nach Stichwort filtern (Inhalt nach Stichwort) | ||||||
---|---|---|---|---|---|---|
|