Entwicklung einer REST-API zur Erstellung und Konfiguration von Microsoft Teams. Jan Kruse, utilitas GmbH

Transkript

1 Entwicklung einer REST-API zur Erstellung und Konfiguration von Microsoft Teams Jan Kruse, utilitas GmbH

2 Gliederung Einleitung Motivation Ziele Grundlagen ASP.Net Web API REST-API Microsoft Office 365 Microsoft Azure Authentifizierung und Autorisierung Definition OAuth 2.0 Protokoll Azure Active Directory als Identity Provider

3 Gliederung Implementierung Architektur Authentifizierung und Autorisierung REST Endpunkte Erstellung von Teams Konfiguration von Teams Fazit

4 Einleitung Motivation Kundenprojekt der utilitas GmbH Erstellung und Konfiguration von Teams aktuell manueller Prozess Sehr aufwändig und fehleranfällig Ziele Sichere REST-API zur Erstellung und Konfiguration von Teams Spätere Einbindung in andere Softwaresysteme

5 ASP.Net Web API Server-seitiges Web-Framework von Microsoft Basiert auf.net-framework Entwicklung von HTTP Schnittstellen HTTP Endpunkt als Klasse Modelliert HTTP Actions sind Methoden

6 REST-API API nach dem REST Paradigma Fast ausschließlich in Verbindung mit HTTP REST Paradigma schreibt Bedingungen für ein Softwaresystem vor Zustandslosigkeit Bessere Wartbarkeit und Skalierbarkeit HTTP Methoden GET - Abrufen POST - Erstellen PUT - Ablegen oder Ersetzen DELETE - Löschen PATCH - Verändern

7 Microsoft Office 365 Cloud Dienst von Microsoft Office Online SharePoint Online Exchange Online Skype for Business Microsoft Teams Verwaltung überazure Active Directory Benutzer Gruppen Anwendungen Programmatischer Zugriff über Graph API

8 Microsoft Azure Sammlung von Cloud Diensten von Microsoft Infrastructure as a Service Virtuelle Maschinen Platform as a Service Azure Web App Software as a Service Hochverfügbar in 42 Regionen weltweit Skalierbar

9 Authentifizierung und Autorisierung Authentifizierung Identifizierung Identifier und Secret (z.b. Benutzer-ID + Passwort) Autorisierung Erteilung von Berechtigungen

10 OAuth 2.0 Protokoll für Zugriff auf geschützte Ressourcen bei Client-Server Anwendungen

11 Active Directory als Identity Provider

12 Architektur

13 Authentifizierung und Autorisierung Schutz der API Benutzung von WindowsAzureActiveDirectoryBearerAuthentication Direkte Einbindung über ASP.Net Web API und OWIN

14 Authentifizierung und Autorisierung Generierung von Access Tokens Verwendung von Active Directory Authentication Library (ADAL)

15 REST Endpunkte

16 Erstellung von Teams POST-Anfrage an Anfrage über.net HTTP-Client Serialisierung und Deserialisierung über Newtonsoft JSON

17 Konfiguration von Teams Beispiel: Verstecken von Teams aus der Globalen Adressliste PowerShell Set-UnifiedGroup <Team ID> -HiddenFromAddressListsEnabled $True Implementierung über.net PowerShell Automation Klassen

18 Fazit Sichere, Skalierbare REST API Aktueller Feature-Umfang Erstellung von Office 365 Gruppen und Teams Verstecken von Teams aus der Globalen Adressliste Änderung des Team-Bildes Hinzufügen von Planner Plänen Unterbindung von Gast-Zugriff Automatisches Hinzufügen von Nachrichten Abonnements Ausblick Erweiterung um weitere Features nicht zwingend Teams spezifisch Einbindung in bestehende und neue Softwaresysteme

19 Live Demo

20 Vielen Dank für Ihre Aufmerksamkeit!

21 Fragen?

22 Literatur R. Fielding, Adobe und J. Rechke. RFC7231. Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content url: (besucht am ). R. Fielding. Architectural Styles and the Design of Network-based Software Architectures. Dissertation. University of California, Irvine, Kap. 5. url: (besucht am ). D. Hardt und Microsoft. The OAuth 2.0 Authorization Framework url: (besucht am ). Microsoft. Getting Started with ASP.NET Web API 2 (C Sharp) url: (besucht am ).

23 Literatur Microsoft. Explore Office 365 for Business url: (besucht am ). Microsoft. Create team url: (besucht am ). Microsoft. Set-UnifiedGroup url: (besucht am ). Microsoft. Microsoft Azure url: (besucht am ).