Thomas Claudius Huber Trivadis Services AG. Daten aus Office 365 in die eigene App integrieren

Transkript

1 Thomas Claudius Huber Trivadis Services AG Daten aus Office 365 in die eigene App integrieren

2 Thomas Claudius Huber Principal Consultant bei Trivadis Pluralsight-Autor, Buchautor C#, XAML, TypeScript, Azure

3 Agenda 1. Was ist der Microsoft Graph? 2. App Registration & Security 3. Microsoft Graph in UWP-App nutzen

4 Die Welt ohne Microsoft Graph Unterschiedliche Endpunkte für Services wie Azure AD Outlook OneDrive Sharepoint Unterschiedliche Authentifizierung für Geschäfts-/Schulkonto Persönliches Konto

5 OneDrive OneDrive for Business user_contoso_com/_api/v2.0/drive Azure Active Directory Graph Outlook Mail REST & Windows Live Profile API Persönliches Konto Sharepoint Profile API files.peoplemanager/getmyproperties Exchange HD Picture API Geschäfts-/Schulkonto Office Graph in Sharepoint Online y?querytext='&properties=...

6 Microsoft Graph fasst die zig Endpunkte zu einem einzigen Endpunkt zusammen:

7 Datenzugriff /me, /users, /groups, /messages, /drive,... Daten ablaufen /drive/items/<id> /lastmodifiedbyuser Auf Insights zugreifen Microsoft Graph /insights/trending Source: microsoft.com

8 Microsoft Graph Abfragen Get my profile Get my files Get my photo Get my mail Get my calendar Get my manager Get users in my organization Get people related to me Get my tasks Get my notes Get trending around me

9 Microsoft Graph Abfrage-Muster Stand heute gibt es zwei Versionen v1.0 für produktiven Einsatz beta für kommende APIs

10 Das Microsoft Graph Portal Enthält - Dokumentation - Beispiele - SDKs - Graph Explorer zum Testen von Abfragen

11 DEMO Erste Schritte mit dem Microsoft Graph via

12 OData Abfragen $select $expand $count $skip $orderby $filter $top $skiptoken

13 OData-Metadaten OData stellt Metadaten zu Entitäten und Aktionen als XML-Datei bereit

14 DEMO Metadaten einsehen und verstehen

15 Aktionen ausführen Metadaten enthalten auch Actions Dateien erstellen, löschen, verschieben,... Excel-Dateien navigieren, aktualisieren, speichern,... Mails erstellen, versenden, beantworten,...

16 DEMO Eine Mail versenden

17 Agenda 1. Was ist der Microsoft Graph? 2. App Registration & Security 3. Microsoft Graph in UWP-App nutzen

18 Quelle:

19 Was muss man tun 1. App registrieren 2. OpenID Connect / OAuth2 verwenden 3. Auf Microsoft Graph zugreifen

20 App registrieren Funktioniert für Geschäfts-/Schulkonto, nicht für persönliches Konto V2.0: - Wird für Azure AD v2.0-endpunkt verwendet - Funktioniert für Geschläfts-/Schulkonto UND für persönliches Konto - /active-directory-v2-limitations/

21 Azure AD v2.0 Endpunkt aufrufen Für OpenID Connect / OAuth2 sind diverse Libraries verfügbar Oder manuell via v2.0 Endpunkt

22 Den Authorize-Endpunkt manuell aufrufen

23 Testen mit dieser URL client_id=enter_app_id &scope=openid+profile &response_type=id_token &redirect_uri= &nonce=enter_random_number_here JSON Web Token (JWT) anschauen:

24 Wenn Du nicht Chuck Norris bist:

25 Wenn Du nicht Chuck Norris Dominic Baier bist: Nur zum Testen manuell aufrufen Ansonsten eine Library / SDK verwenden Azure AD Authentication Libary (ADAL) Microsoft Authentication Library (MSAL)... NuGet: Microsoft.Identity.Client (preview for.net) Dominic s Session zu OpenID Connect / OAuth2: 21. Sept, 16:15-17:30, Gutenberg 1

26 Agenda 1. Was ist der Microsoft Graph? 2. App Registration & Security 3. Microsoft Graph in UWP-App nutzen

27 REST oder SDK? SDK via NuGet: Microsoft.Graph OAuth2: Microsoft.Identity.Client (noch in Preview) Samples unter github.com/microsoftgraph Enthalten AuthenticationHelper-Klasse Zeigen sowohl REST als auch SDK

28 OneDrive Daten abrufen

29 OneDrive Daten abrufen var graphclient = AuthenticationHelper.GetAuthenticatedClient(); var request = graphclient.me.drive.root.search(".jpg").request().top(10); var collection = await request.getasync();

30 Inhalt eines Bildes abrufen var graphclient = AuthenticationHelper.GetAuthenticatedClient(); var request = graphclient.me.drive.items[selecteditem.id].content.request(); var stream = await request.getasync();

31 Mail versenden var request = graphclient.me.sendmail( message, false).request(); await request.postasync();

32 Agenda 1. Was ist der Microsoft Graph? 2. App Registration & Security 3. Microsoft Graph in UWP-App nutzen

33 Summary

34 Microsoft Graph vs. spezifische API Der Microsoft Graph ist eine Facade Im Hintergrund werden spezifische APIs aufgerufen, bspw. Onedrive: Outlook: Spezifische API nur dann verwenden, wenn Funktion in Microsoft Graph nicht vorhanden ist

35 Summary Microsoft Graph vereinheitlicht Zugriff auf O365-Daten Integration in die eigene App gestaltet sich simpel Es existieren zahlreiche SDKs REST-APIs lassen sich auch ohne SDK auf jeder Plattform aufrufen

36 Info / Resourcen Kontakt thomas.huber@trivadis.com Session-Inhalt: Office 365 Demo-Umgebung anlegen: Graph Samples: