Versionen im Vergleich

Alte Version 7

changes.mady.by.user Heinz Zimmermann

Gespeichert am

verglichen mit

Neue Version 8

changes.mady.by.user Former user

Gespeichert am

Schlüssel

  • Diese Zeile wurde hinzugefügt.
  • Diese Zeile wurde entfernt.
  • Formatierung wurde geändert.

Status
colourYellow
titleWMS 1.1.4

Link: https://docs.microsoft.com/de-de/graph/use-the-api

Microsoft Graph ist eine mächtige umfangreiche Sammlung verschiedener RESTful-Web-APIAPIs, 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 (.

Endpunkt: https://docs.microsoft.com/de-de/graph/auth-v2-service).use-the-api
Wie wird authentifiziert? API-Key
Wo finde ich Hilfe? https://apidocs.teamup.com/

Key-Features

  • Verwenden von Header

  • Verwenden eines FormUrlEncoded-ContentsContents im Format “form-url-encoded”

  • Verwenden eines durch Login ermittelten Bearer-Tokens

Inhalt

toc

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”Keine

Header

Im Header müssen folgende Einträge hinzugefügt werden:

  • “User-Agent” : <Name der registrierten App>

  • “cache-control” : “no-cache”

Image Removed

Image RemovedImage AddedImage Added

HTTP-Endpunkt für die Graph-API (z.B. zur Termin-Erstellung)

Name

Beschreibung

Name

Name, welcher Microsoft Graph Loginz.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”Keine

Header

Im Header müssen folgende Einträge hinzugefügt werden:

  • “User-Agent”: <Name der registrierten App>

Image Removed

Image Removed

  • App aus dem Azure Portal>

Image AddedImage Added

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”POST

Header

Es sind keine Header erforderlich

Content

Alle für die Authentifizierung notwendigen Daten werden als FormUrlEncoded Content angegeben. Dies sind im Folgenden:

  • “client_id” : <Anwendungs-ID> (ist aus dem Azure-Portal bei der App-Registrierung zu entnehmen)

  • “client_secret” : <Dev secret> (wird bei der Registrierung der Anwendung erzeugt und ist danach nicht mehr einsehbar!)

  • “grant_type” : “client_credentials”

  • “scope” : “https://graph.microsoft.com/.default“

Image Removed

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
{
languagejson
{   
  "token_type": "Bearer",

   
  "expires_in": 3599,

   
  "ext_expires_in": 3599,

   
  "access_token": "xxx"


}

Image Removed

Termin erstellen

Image AddedImage Added

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”POST

Header

Im Header muss das Bearer-Token übergeben werden, welches aus dem Ergebnis des Logins ausgelesen werden kann:

  • “Authorization” : “Bearer <ermitteltes Token>“
    (Leerzeichen zwischen “Bearer” und Token beachten!)

Image Removed

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:

  • Content: Kalender-Objekt im Json-Format (Details zum Objekt finden sich in der Microsoft Graph API-Beschreibung)

  • ContentType: application/json

  • Encoding: Unicode (UTF-8) mit BOM

Image Removed

Info

Es ist vermutlich einfacher, das Jsonden JSON-Objekt Text in einer Text-Datei bzw. Ressource zu erstellen und mit Platzhalter zu versehen, welche dann mit den richtigen Daten ersetzt werden, anstatt das Jsonden JSON-Objekt Text direkt hier im Content einzugeben. Da die .

Ggf müssen auch Sonderzeichen (z.B. das Hochkommas mit einem zweiten Hochkomma “escapted” werden müssen, kann dies ) “escaped” werden. Das kann schnell unübersichtlich werden und damit zu einem ein ungültiges ungültigem Json-Objekt erstellt werdenführen.

Image RemovedImage AddedImage AddedImage Added

Verwandte Themen

Nach Stichwort filtern (Inhalt nach Stichwort)
showLabelsfalse
showSpacefalse
cqllabel = "http" and type = "page" and space = "APM2019DE" and ancestor = "150667523"
Nach Stichwort filtern (Inhalt nach Stichwort)
showLabelsfalse
showSpacefalse
cqllabel = "http" and type = "page" and space = "APM2019DE" and ancestor = "431292510"