Latest / M365.FM – Microsoft 365, Copilot & KI Podcast auf Deutsch / Microsoft Graph Webhooks einfach erklärt: Echtzeit-Benachrichtigungen statt ständigem Polling (KI-Synchronfassung)

Transcript

Microsoft Graph Webhooks einfach erklärt: Echtzeit-Benachrichtigungen statt ständigem Polling (KI-Synchronfassung) · M365.FM – Microsoft 365, Copilot & KI Podcast auf Deutsch

• 0:00
  Bereit für 10 Tage Microsoft 365, Co-Pilot, KI, Azure und die Menschen, die die Zukunft der Arbeit gestalten?
• 0:07
  Diesen Januar ist die M365-Con zurück und wird noch größer.
• 0:11
  Seien Sie dabei bei Live Sessions, Demos aus der Praxis und praktischem Wissen von MVPs und Branchenexperten aus aller Welt.
• 0:18
  Keine generischen Folien, keine endlosen Schlagworte.
• 0:21
  Wir stellen uns den echten Herausforderungen.
• 0:23
  Co-Pilot Studio, KI Agents Fabric, Sicherheit, Governance und Automatisierung.
• 0:27
  Ganz gleich, ob Sie IT-Experte, Entwickler oder Führungskraft sind, es gibt speziell auf Sie zugeschnittene Sessions.
• 0:35
  An 10 vollen Tagen können Sie verschiedene Technologien kennenlernen und sich mit einer globalen Community vernetzen.
• 0:40
  Sehen Sie sich die Live-Übertragung an und nehmen Sie praktische Einblicke mit nach Hause in Ihr Unternehmen.
• 0:45
  Januar 2027, 10 Tage, eine Microsoft-Community. Die Registrierung ist ab sofort möglich.
• 0:51
  Besuchen Sie m35560.com.net und sichern Sie sich noch heute Ihren Platz.
• 0:55
  Das ist m355.net, der in der Erde.
• 1:00
  Melden Sie sich jetzt auf m35560.com.net an und wir sehen uns im Januar live.
• 1:05
  Hallo zusammen und herzlich willkommen zu einer weiteren Folge von Microsoft Knowledge Nuggets hier auf m355.fm.
• 1:10
  Ich bin euer Moderator Milko Peters.
• 1:11
  Das heutige Thema ist eines, von dem fast jeder, der mit Microsoft 365 arbeitet, schon einmal gehört hat.
• 1:15
  Aber nur sehr wenige können es verständlich erklären.
• 1:17
  Was genau sind GraphWebhooks?
• 1:19
  Warum sollten Sie sich mit Ihnen befassen, anstatt die Dinge auf die altbewährte Weise zu tun?
• 1:22
  Stellen Sie sich vor, Sie erwarten einen wichtigen Brief.
• 1:23
  Sie gehen zu Ihrem Briefkasten, er ist leer.
• 1:25
  Sie gehen zurück.
• 1:26
  Zehn Minuten später sehen Sie erneut nach.
• 1:28
  Immer noch nichts.
• 1:29
  Sie tun dies den ganzen Tag und verschwenden Zeit und innig.
• 1:31
  Das ist Polling.
• 1:31
  Stellen Sie sich nun eine andere Welt vor.
• 1:33
  Der Postbote klingelt bei Ihnen, sobald ein Brief eintrifft.
• 1:35
  Sie schauen nicht nach.
• 1:36
  Sie warten, bis es klingelt.
• 1:37
  Das sind Webhooks.
• 1:38
  Am Ende dieser Folge werden Sie verstehen, was GraphWebhooks sind,
• 1:41
  warum Sie die ständige Überprüfung ersetzen und wie die einzelnen Teile zusammenpassen.
• 1:45
  Das Polling-Problem.
• 1:46
  Lassen Sie uns das auf.
• 1:47
  Um zu verstehen, warum Webhooks wichtig sind, müssen Sie verstehen, warum Polling schädlich ist.
• 1:51
  So funktionieren die meisten Anwendungen heute.
• 1:53
  Ihr Rand benötigt einer.
• 1:54
  Sie fragt Microsoft Graph, hey, gibt es neue Benutzer?
• 1:57
  Graph antwortet nein.
• 1:59
  Ihre App wartet also einen Moment und fragt dann erneut, gibt es inzwischen neue Benutzer?
• 2:02
  Immer noch keine.
• 2:03
  Dieser Prozess wird als Abfrage gezeigt.
• 2:05
  Stellen Sie sich vor, Sie rufen ständig einen Freund an, um zu fragen, ob er Neuigkeiten hat.
• 2:08
  Sie wählen den Anruf, er nimmt ab, Sie fragen nachher, er sagt nein, Sie legen auf.
• 2:11
  Dann rufen Sie fünf Minuten später erneut an und dann wieder.
• 2:13
  Sie verschwenden seine Zeit um ihre eigene.
• 2:15
  Wahrscheinlich nerven Sie ihn sogar.
• 2:16
  Stellen Sie sich nun vor, tausende von Apps würden Microsoft Graph gleichzeitig auf diese Weise abfragen.
• 2:19
  Jede App fragt alle paar Minuten die gleichen Fragen ab und erhält die gleichen Antworten.
• 2:23
  Äh, das sind eine Menge Lärm.
• 2:25
  Microsoft hat einen Begriff für zu aggressive Abfragen.
• 2:28
  Drosselung oder wie manche Entwickler es nennen, Graph Jail.
• 2:32
  Wenn Sie zu viele Anfragen senden, sagt Microsoft, okay, das war's für eine Weile.
• 2:35
  Microsoft begrenzt die Anzahl der Aufrufe Ihrer App.
• 2:37
  Sobald Sie gedrosselt sind, wird alles langsamer.
• 2:39
  Legitime Anfragen häufen Sie.
• 2:40
  Ihre App funktioniert in Ordnung.
• 2:41
  Sie wissen nicht, wann Sie entlassen werden.
• 2:44
  Über wie viele Anforderungen sprechen wir?
• 2:45
  Angenommen, Ihre App fragt alle fünf Minuten Benutzeränderungen ab.
• 2:48
  Das entspricht zwölf Anforderungen pro Stunde.
• 2:50
  Über einen ganzen Tag verteilt sind das 82 Anforderungen und das nur für eine Ressource.
• 2:54
  Wenn Sie außerdem Gruppen, Dateien, Nachrichten und Kalenderereignisse abfragen, entstehen pro Tag tausende unnötige Anforderungen.
• 3:00
  Die meisten davon geben nichts zurück, also null Änderungen.
• 3:02
  Dennoch haben Sie den Anruf getätigt.
• 3:03
  Und hier ist der Clou.
• 3:04
  Selbst wenn Sie alle fünf Minuten eine Abfrage durchführen, erhalten Sie immer noch keine Echtzeitaktualisierung.
• 3:08
  Eine Minute nach Ihrer letzten Abfrage könnte sich etwas ändern.
• 3:11
  Sie erfahren erst in vier Minuten davon.
• 3:12
  Sie verschwenden Ressourcen und verpassen trotzdem das Zeitfenster.
• 3:16
  Vergleichen Sie das nur mit einem Ereignis gesteuerten Ansatz.
• 3:18
  Anstatt Microsoft Graph alle paar Minuten aufzurufen, warten Sie, bis Microsoft Graph Sie anruft.
• 3:21
  Sie richten einen Listener ein.
• 3:23
  Wenn sich etwas ändert, sendet Ihnen Graph eine Benachrichtigung.
• 3:25
  Sie wählen nicht.
• 3:26
  Sie nehmen ab, wenn das Telefon klingelt.
• 3:28
  Was sind Webhooks?
• 3:29
  Was genau ist ein Webhook?
• 3:31
  Hier ist die einfachste Definition.
• 3:32
  Ein Webhook ist eine HTTP-Anforderung, die automatisch gesendet wird, wenn etwas passiert.
• 3:36
  Sie fragen nicht danach.
• 3:37
  Der Server sendet Sie einfach an Sie.
• 3:39
  Stellen Sie sich das wie eine Türklein.
• 3:40
  Sie stehen nicht draußen und schauen alle paar Minuten nach der Tür.
• 3:43
  Die installieren eine Klingel.
• 3:44
  Wenn jemand hereinkommt, klingelt er.
• 3:45
  Wir hören das Klingeln und antworten.
• 3:47
  Die Türklingel übernimmt die Überwachung für Sie.
• 3:49
  Webhooks werden manchmal auch als umgekehrte APIs bezeichnet.
• 3:51
  Bei einer normalen API stellt Ihre App eine Anforderung und der Server antwortet.
• 3:55
  Ihre App hat die Kontrolle.
• 3:56
  Bei einem Webhook sendet der Server die Anforderung an Ihre App.
• 3:59
  Der Server hat die Kontrolle, überträgt aber Daten, anstatt auf Ihre Anfrage zu warten.
• 4:02
  Microsoft Graph verwendet mittlerweile auch Webhooks.
• 4:04
  Microsoft nennt sie jedoch Änderungsbenachrichtigungen.
• 4:07
  Es ist dasselbe, nur der Name ist anders.
• 4:08
  Wenn sich in Microsoft 365 etwas ändert, sendet Graph eine HTTP-Postnachricht an eine von Ihnen angegebene URL.
• 4:15
  Diese Postnachricht enthält Informationen darüber, was ich gerne habe.
• 4:17
  Es gibt viele Dinge, über die Sie benachrichtigt werden können.
• 4:20
  Ein neuer Benutzer wird in Ihrem Mandanten erstellt, eine Datei in SharePoint aktualisiert,
• 4:24
  eine Nachricht in Teams gesendet, ein Kalenderereignis geändert oder eine Gruppe erhält, ein neues Mitglied.
• 4:28
  All diese Ereignisse können eine Benachrichtigung auslösen.
• 4:30
  Hier ist ein Beispiel aus der Praxis.
• 4:31
  Angenommen, Sie leiten ein Unternehmen mit einem Zeiterfassungssystem.
• 4:34
  Wenn ein neuer Mitarbeiter einsteigt, möchten Sie automatisch ein Konto erstellen.
• 4:37
  Ohne Webhooks fragen Sie den Benutzer im Punkt alle paar Minuten ab, um zu prüfen, ob neue Personen hinzukommen.
• 4:41
  Mit Webhooks abonnieren Sie Ereignisse zur Benutzererstellung.
• 4:44
  Wenn jemand beitritt, sendet Graph Ihrer App eine Benachrichtigung.
• 4:47
  Ihre App empfängt diese, validiert Sie und erstellt das Konto alles innerhalb von Sekunden.
• 4:51
  Keine Abfragen, keine verschwendeten Anforderungen.
• 4:53
  Ein weiteres Beispiel.
• 4:55
  Sie haben eine SharePoint-Dokumentbibliothek in die Belege hochgeladen werden.
• 4:57
  Ohne Webhooks fragen Sie die Bibliothek ständig ab.
• 5:00
  Mit Webhooks benachrichtigt Sie Graph, sobald eine Datei hinzugefügt wird.
• 5:03
  Ihre App ruft die Datei ab, prüft, ob es sich um einen Beleg handelt und verarbeitet sie automatisch.
• 5:07
  Das ist die Stärke von Webhooks.
• 5:08
  Anstatt dass Ihre App ständig fragt, gibt es etwas Neues?
• 5:11
  Lassen Sie sich vom System benachrichtigen, wenn etwas passiert.
• 5:13
  Das ist effizienter, zuverlässiger und viel schneller.
• 5:17
  Funktionsweise von Microsoft Graph Webhooks
• 5:18
  Wissen Sie, was Webhooks sind und warum Abfragen das Problem darstellen?
• 5:21
  Sehen wir uns nun an, wie Microsoft Graph Webhooks tatsächlich funktionieren.
• 5:24
  Denn der Ablauf ist einfacher, als Sie vielleicht denken.
• 5:26
  Er beruht auf drei Elementen.
• 5:27
  Einem Abonnement, einer Benachrichtigung und Ihrem Endpunkt.
• 5:31
  Zuerst erstellen Sie ein Abonnement.
• 5:32
  Sie teilen Microsoft Graph mit.
• 5:34
  Hey, ich möchte wissen, wenn sich etwas Bestimmtes ändert.
• 5:36
  Sie geben Graph die Details darüber, was beobachtet werden soll und wohin die Nachrichten gesendet.
• 5:39
  Stellen Sie sich das für die Anmeldung für eine Benachrichtigung.
• 5:41
  Sie teilen dem System mit, was Sie interessiert und geben Ihre Kontaktinformation an.
• 5:44
  Zweitens überwacht Microsoft Graph diese Ressource.
• 5:46
  Es sucht nach Änderungen.
• 5:47
  Wenn etwas passiert, so mal.
• 5:48
  Wenn ein Benutzer etwas erstellt, eine Datei aktualisiert oder eine Nachricht eingeht, wird Graph darüber informiert.
• 5:52
  Drittens sendet Graph eine Benachrichtigung.
• 5:54
  Es sendet eine HTTP-Postbefehl an die von Ihnen angegebene URL.
• 5:57
  Dieser Post enthält Informationen darüber, was sich geändert hat.
• 6:00
  Ihr Endpunkt empfängt die Benachrichtigung und Ihre Anwendung verarbeitet sich.
• 6:02
  Der allgemeine Ablauf ist also einfach.
• 6:04
  Sie abonnieren. Graph überwacht die Änderungen.
• 6:06
  Graph sendet eine Postnachricht, wenn sich etwas ändert.
• 6:08
  Lassen Sie uns diese drei Bausteine etwas genauer aufschlösen.
• 6:10
  Das Abonnement ist Ihre Anforderung, benachrichtigt zu werden.
• 6:13
  Das ist so, als würden Sie sagen, ich möchte wissen, wenn mein Mandant ein neuer Benutzer hinzugefügt wird.
• 6:16
  Sie senden diese Anforderung an Microsoft Graph, speichert sie.
• 6:19
  Von diesem Zeitpunkt an überwacht Graph die Änderungen in Ihrem Auftrag.
• 6:22
  Die Benachrichtigung ist der eigentliche Alarm.
• 6:24
  Eine HTTP-Postnachricht, die Graph an Ihren Endpunkt sendet.
• 6:26
  Der Posttext enthält Details zur Änderung zum Beispiel.
• 6:29
  Wer welche Ressource sich geändert hat, welche Art von Änderungen stattgefunden hat oder wann sie stattgefunden haben.
• 6:32
  Ihr Endpunkt ist die Tür, die Sie offen lassen.
• 6:34
  Es handelt sich um eine URL auf Ihrem Server, die für den Empfang dieser Postanforderung konfiguriert.
• 6:37
  Sie muss nur lauschen und schnell reagieren.
• 6:39
  Das ist alles.
• 6:40
  Auf der empfangenen Seite ist keine komplexe Logik erforderlich.
• 6:42
  Sie fangen einfach die Benachrichtigung ab, bestätigen Sie und verarbeiten Sie.
• 6:45
  Vergleichen Sie diesen mit dem Abruf.
• 6:46
  Beim Abruf fehlen hunderte von GT-Anforderungen die jeweils fragen, gibt es etwas Neues?
• 6:50
  Neues?
• 6:51
  Meistens lautet die Antwort Nein.
• 6:52
  Bei Webhooks gibt es nur einen Post, die Benachrichtigung.
• 6:55
  Das ist alles.
• 6:56
  Eine Nachricht anstelle von hundert.
• 6:57
  Der Effizienzunterschied ist enorm.
• 6:59
  Und Ihr Endpunkt muss nicht kompliziert sein.
• 7:01
  Er muss nur öffentlich zugänglich sein, HTTPS sprechen und schnell reagieren.
• 7:05
  Wir sprechen gleich darüber, was schnell bedeutet.
• 7:07
  Aber die Kernidee ist einfach.
• 7:09
  Ihr Endpunkt hört zu, Graph ruft auf, Sie reagieren und fertig.
• 7:14
  Erstellen ins Abonnement.
• 7:15
  Wie richtet man nun ein solches Abonnement?
• 7:17
  Lassen Sie uns Schritt für Schritt durch die Erstellung eines Abonnements gehen.
• 7:20
  Sie beginnen, indem Sie eine HTTP-Postanforderung an eine bestimmte URL Microsoft Graph senden.
• 7:24
  Diese URL lautet https.com.
• 7:29
  Sie senden direkt an den Endpunkt für Abonnements.
• 7:31
  In diesem Anforderungstext geben Sie die Details zu den Inhalten an, die Sie abonnieren möchten.
• 7:35
  Sie müssen vier wichtige Felder angeben.
• 7:37
  Als erstes ist die Benachrichtigungs-URL.
• 7:39
  Dies ist die URL Ihres Endpunkts, an die Microsoft Graph die Benachrichtigungen sendet.
• 7:43
  Es muss HTTPS sein und der Zugriff muss öffentlich sein, da Graph über das Internet darauf zugreifen muss.
• 7:47
  Zweitens die Ressource.
• 7:49
  Hiermit teilen Sie Graph mit, was Sie überwachen möchten.
• 7:51
  Sie geben den Pfad zur Microsoft Graph Ressource an.
• 7:53
  Beispielsweise Benutzer, wenn Sie auf Benutzsenderungen achten möchten.
• 7:55
  Oder Posteingangsnachrichten, wenn Sie auf neue E-Mails in Ihrem Posteingang achten möchten.
• 8:00
  Die Ressource teilt Graph genau mit, was für Sie wichtig ist.
• 8:02
  Drittens der Änderungstyp.
• 8:04
  Hiermit teilen Sie Graph mit, über welche Art von Änderungen Sie benachrichtigt werden sollten.
• 8:07
  Sie können erstellt, aktualisiert, gelöscht oder eine beliebige Kombination davon angeben.
• 8:11
  Wenn Sie also nur an der Erstellung neuer Benutzer interessiert sind, legen Sie den Änderungstyp auf erstellt fest.
• 8:14
  Wenn Sie auch an Aktualisierungen interessiert sind, legen Sie ihn auf erstellt oder aktualisiert fest.
• 8:17
  Viertens das Ablaufdatum slash Zeit.
• 8:19
  Dies ist der Zeitpunkt, an dem das Abonnement abläuft, da Abonnements nicht unbegrenzt gültig sind.
• 8:22
  Sie legen ein Datum und eine Uhrzeit fest und Graph sendet danach keine Benachrichtigungen mehr.
• 8:27
  Die maximale Dauer hängt von der Ressource ab, die Sie überwachen.
• 8:29
  Für Benutzer und Gruppen beträgt die maximale Dauer ca. 3 Tage.
• 8:31
  Für Laufwerkelemente in SharePoint oder OneDrive kann Sie bis zu 30 Tage betragen.
• 8:36
  Sie müssen die Dokumentation für jeden Ressourcentyp prüfen.
• 8:38
  Es gibt außerdem ein erwähnenswertes optionales Feld, die Client-Status.
• 8:41
  Dies ist eine geheime Zeichenfolge, die Sie erstellen.
• 8:43
  Sie können einen beliebigen Wert eingehen.
• 8:45
  Eine zufällige Zeichenfolge, eine gültige Zeichenfolge.
• 8:47
  Microsoft Graph fügt diesen Wert in jede Benachrichtigung ein, die an Ihren Endpunkt gesendet wird.
• 8:51
  Und Sie verwenden ihn, um zu überprüfen, ob die Benachrichtigung tatsächlich von Ihrem Abonnement stammt.
• 8:55
  Wenn jemand versucht, gefälschte Benachrichtigungen an Ihren Endpunkt zu senden,
• 8:58
  stimmt der Client-Status nicht überein und Sie können die Benachrichtigung sofort ablehnen.
• 9:01
  Dies ist eine einfache Sicherheitsmaßnahme wichtig.
• 9:03
  Das Erstellen eines Abonnements ist wie das Abonnieren eines Zeitungsartikels.
• 9:07
  Sie geben der Zeitung Ihre Adresse.
• 9:08
  Das ist Ihre Benachrichtigungs-URL.
• 9:10
  Sie teilen der Zeitung mit welchen Rubriken Sie erhalten möchten und geben Ihre Ressourcen in Endungen.
• 9:13
  Außerdem geben Sie an, wie lange die Zustellung fortgesetzt werden soll.
• 9:16
  Es ist Ihr Ablaufdatum und die Uhrzeit.
• 9:17
  Die Zeitung kümmert sich um Interessen.
• 9:19
  Aber hier ist der Clou, Abonnements laufen ab.
• 9:21
  Sie können kein Abonnement erstellen und dann vergessen.
• 9:23
  Nach Ablauf des Ablaufdatums sendet Graph keine Benachrichtigungen mehr und Ihr Abonnement ist nicht mehr gültig.
• 9:29
  Wenn Sie weiterhin Benachrichtigungen erhalten möchten, müssen Sie das Abonnement vor Ablauf verlängern.
• 9:33
  Senden Sie dazu eine Patch-Anforderung und einen neuen Ablaufdatum oder einer neuen Uhrzeit an den Abonnement.
• 9:37
  Das Erstellen eines Abonnements ist also der erste Schritt, aber nicht der Lekt.
• 9:39
  Sie müssen den Lebenszyklus verwalten.
• 9:41
  Darauf gehen wir später noch genauer an.
• 9:43
  Der Validierungshandshake.
• 9:44
  Bevor Ihr Abonnement live geht, gibt es einen Schritt, den Sie nicht überspringen dürfen.
• 9:47
  Microsoft Graph akzeptiert nicht einfach nur Ihre Abonnementanforderung und beginnt mit dem Senden von Benachrichtigungen.
• 9:51
  Zunächst muss bestätigt werden, dass Ihr Endpunkt echt und bereit ist, Benachrichtigungen zu empfangen.
• 9:55
  Und so funktioniert es.
• 9:56
  Wenn Sie Ihre Beitragsanforderungen zum Erstellen eines Abonnements senden,
• 9:59
  sendet Microsoft Graph sofort einen Testbeitrag an Ihre Benachrichtigungs-URL.
• 10:02
  Dieser Testbeitrag enthält eine Abfrageparameter namens Validierungstoken.
• 10:06
  Es handelt sich dabei nur um eine zufällige Zeit.
• 10:07
  Ihr Endpunkt muss dieses Token abrufen und als nur Textantwort zurücksenden.
• 10:11
  Dies muss innerhalb von 10 Sekunden erfolgen.
• 10:13
  Stellen Sie sich, dass wir ein Kurier vor, der ein Paket ausliefert.
• 10:15
  Er steht vor Ihrer Tür und fragt, ist das die richtige Adresse?
• 10:17
  Können Sie das bestätigen?
• 10:18
  Sie müssen dafür unterschreiben.
• 10:20
  Wenn Sie das nicht tun, gehen Sie weg.
• 10:20
  Der Kurier hinterlässt das Paket nicht.
• 10:23
  Sie gehen einfach.
• 10:24
  Genau das passiert hier.
• 10:25
  Microsoft Graph sagt, ich bin dabei, Ihnen wichtige Benachrichtigungen zu senden.
• 10:29
  Beweisen Sie, dass Sie die richtige Person an der richtigen Adresse sind.
• 10:33
  Ihr Endpunkt antwortet, indem er das Validierungstoken zurücksendet,
• 10:35
  das Graph mitteilt, ja, ich bin hier.
• 10:38
  Ich höre zu.
• 10:39
  Send Sie mir die Benachrichtigung.
• 10:41
  Hier stolpern nun viele Entwickler.
• 10:43
  Das Validierungstoken muss als nur Text zurückgegeben werden.
• 10:45
  Ich als JSON nicht als HTML, sondern als nur Text.
• 10:47
  Und die Antwort muss ein Content-Type-Header aufweisen, der auf Gagslash-Plant ist.
• 10:50
  Wenn Sie sie in JSON verpackt oder auf andere Weise codiert zurücksenden, schlägt die Validierung fehl.
• 10:55
  Ihr Abonnement wird nicht erstellt.
• 10:57
  Microsoft Graph gibt einen Fehler zurück und Sie können sich fragen, was schief gelaufen ist.
• 11:00
  Es gibt noch ein weiteres technisches Detail, das es zu wissen gibt.
• 11:02
  Der Validierungsdienst von Microsoft Graph unterstützt TLS 1.3 nicht zuverlässig.
• 11:06
  Er verhandelt TLS 1.2 aus.
• 11:07
  Wenn Ihr Endpunkt also nur TLS 1.3-Verbindungen akzeptiert, steckt der Validierungshandshake fehl, bevor Ihr Anwendungscode überhaupt ausgeführt wird.
• 11:14
  Sie müssen sicherstellen, dass Ihr Endpunkt TLS 1.2 unterstützt, zumindest für den Validierungsschritt.
• 11:19
  Danach können Sie eine beliebige TLS-Version für die eigentlichen Benachrichtigungen erzwingen.
• 11:23
  Die gute Nachricht ist, dass dieser Validierungshandshake nur einmal pro Abonnement wird.
• 11:27
  Ihr Endpunkt muss ihn nicht jedes Mal verarbeiten, wenn eine Benachrichtigung eintrifft, sondern nur beim ersten Mal.
• 11:31
  Sobald Graph bestätigt hat, dass Ihr Endpunkt echt ist, vertraut es ihm für die gesamte Laufzeit des Abonnements.
• 11:36
  Sie müssen dies also nur einmal richtig machen.
• 11:39
  Umgang mit Benachrichtigung und Sicherheit
• 11:40
  Sobald der Validierungshandshake abgeschlossen ist und Ihr Abonnement live geschaltet wird, beginnt Microsoft Graph mit dem Senden dieser Benachrichtigung.
• 11:46
  Wie sehen diese in der Praxis aus?
• 11:49
  Wenn sich etwas ändert, sendet Graph eine HTTP-Postnachricht mit einem JSON-Objekt im Textkörper an ihren Endpunkt.
• 11:54
  Dieses Objekt enthält die geänderte Ressource, den Typ der Änderung, die erstellt, aktualisiert oder gelöscht wurde und einen Zeitstempel.
• 11:59
  Und einen Zeitstempel.
• 12:00
  Es enthält auch den Client-Status-Wert, den Sie beim Erstellen des Abonnements festgelegt haben.
• 12:04
  Das ist Ihre geheime Zeichenfolge, anhand derer Sie erkennen, ob die Nachricht echt ist.
• 12:07
  Das Erste, was Sie tun sollten, wenn eine Benachrichtigung eintrifft, überprüfen Sie den Client-Status.
• 12:11
  Vergleichen Sie den Wert in der Benachrichtigung mit dem Geheimnis, das Sie beim Erstellen des Abonnements gespeichert haben.
• 12:15
  Wenn Sie nicht übereinstimmen, verwerfen Sie die Benachrichtigung sofort, da es sich um eine Fälschung handeln könnte,
• 12:18
  bei der jemand versucht, Ihr System zur Verarbeitung ungültiger Daten zu veranlassen.
• 12:21
  Dies ist wichtig, da sich Ihr Endpunkt im öffentlichen Internet befindet.
• 12:24
  Jeder, der Ihre URL kennt, könnte eine Postnachricht an Sie senden.
• 12:26
  Ohne die Überprüfung des Client-Status hätten Sie keine Möglichkeit, zwischen einer echten und einer gefälschten Microsoft-Graph-Benachrichtigung zu unterscheiden.
• 12:33
  Es handelt sich um eine einfache Überprüfung, die jedoch Ihre erseilt.
• 12:35
  Sobald Sie bestätigt haben, dass die Benachrichtigung legitim ist, müssen Sie schnell reagieren.
• 12:39
  Microsoft-Graph erwartet innerhalb von drei Sekunden eine HTTP-Antwort der Stufe 200.
• 12:43
  Wenn dies länger dauert, wird dies von Graph bemerkt.
• 12:45
  Und wenn dies zu häufig vorkommt, behandelt Graph sie anders.
• 12:48
  So funktioniert die Drosselung.
• 12:49
  Wenn mehr als 10% Ihrer Antworten innerhalb eines Zeitraums von 10 Minuten das Zeitfenster von drei Sekunden überschreiten,
• 12:54
  kennzeichnet Microsoft-Graph Ihren Endpunkt als langsam.
• 12:57
  In diesem Fall werden neue Benachrichtigungen um 10 Minuten verzögert.
• 13:00
  Sie kommen zwar trotzdem irgendwann an, aber die Zustellung in Echtzeit geht verloren.
• 13:03
  Und wenn es noch schlimmer wird und mehr als 15% Ihrer Antworten 10 Sekunden überschreiten,
• 13:07
  kennzeichnet Graph Ihren Endpunkt als verworfen.
• 13:09
  In diesem Zustand werden Benachrichtigungen für 10 Minuten vollständig verworfen.
• 13:12
  Und jetzt kommt Deckner Punkt.
• 13:13
  Verworfene Benachrichtigungen können nicht wiederhergestellt werden.
• 13:15
  Sie sind weg und Sie erhalten sie nie wieder.
• 13:17
  Stellen Sie sich das wie eine besetzte Telefonleitung vor.
• 13:19
  Wenn Sie nicht schnell abnehmen, versucht es der Anrufer später einmal.
• 13:21
  Wenn Sie jedoch nie abnehmen, gibt der Anrufer irgendwann auf.
• 13:24
  Microsoft Graph ist der Anrufer und Ihr Endpunkt ist das Telefon.
• 13:28
  Nehmen Sie schnell ab, sonst riskieren Sie, dass die Nachricht verloren wird.
• 13:30
  Visita sehe die bewährte Methode.
• 13:31
  Verstehen Sie die Benachrichtigung sofort und verarbeiten Sie sie asynchron.
• 13:34
  Ihr Endpunkt sollte den Status des Clients überprüfen, die Benachrichtigung akzeptieren
• 13:37
  und so schnell wie möglich eine 200- oder 200-Wort zurückgeben.
• 13:41
  Schieben Sie dann die Benachrichtigung zur Hintergrundverarbeitung in eine Warteschlange.
• 13:44
  Eine Azure-Warteschlange, ein Servicebus oder sogar eine einfache Datenbanktabelle.
• 13:47
  Es geht darum, den Antwortzyklus schnell zu beenden und Ihrer Hintergrundworker die schwere Arbeit erledigen zu lassen.
• 13:52
  Noch ein Sicherheitshinweis.
• 13:53
  Ihr Endpunkt muss ausnahmslos HTTPS sein.
• 13:56
  Microsoft Graph sendet keine Benachrichtigungen an einen HTTP-Endpunkt.
• 14:00
  Ihr Endpunkt muss öffentlich zugänglich sein.
• 14:02
  Wenn er sich hinter der Firewall und dem VPN befindet, kann Graph nicht daran.
• 14:04
  Für die Entwicklung können Sie Tools wie ein GORG verwenden, um einen öffentlichen Tunnel zu Ihrem lokalen Computer zu erstellen.
• 14:09
  In der Produktion muss sich Ihr Endpunkt jedoch an einem Ort befinden, an dem Graph ihn finden kann.
• 14:14
  Benachrichtigungen am Leben erhalten Lebensstunden.
• 14:16
  Sie haben also Ihr Abonnement eingerichtet, die Benachrichtigungen werden empfangen und alles sieht gut aus.
• 14:20
  Aber es gibt etwas, das viele Leute überraschen.
• 14:22
  Ihr Abonnement hat ein Ablaufdatum.
• 14:24
  Es geht nicht unbegrenzt.
• 14:25
  Je nachdem, welche Ressource Sie sich ansehen, beträgt die maximale Abonnementdauer in der Regel zwischen drei und sieben Tagen.
• 14:29
  Bei einigen Ressourcen, B-Lauf-Works-Elementen in SharePoint, können Sie bis zu 30 Tage erhalten.
• 14:34
  Allerdings ist dies nicht dauerhaft.
• 14:35
  Sie können kein Abonnement erstellen und es dann vergessen.
• 14:38
  Stellen Sie es sich wie ein Zeitschriftenabonnement vor.
• 14:40
  Sie melden sich an, erhalten die ersten Ausgaben und alles ist prima.
• 14:43
  Wenn Sie Ihr Abonnement jedoch nicht vor Ablauf verlängern, erhalten Sie keine Ausgaben mehr.
• 14:46
  Dasselbe gilt hier.
• 14:47
  Wenn Ihr Abonnement abläuft, sendet Microsoft Graph keine Benachrichtigungen mehr.
• 14:50
  Sie bemerken dies möglicherweise erst, wenn Sie sich wundern, warum nichts passiert.
• 14:53
  Daher benötigen Sie eine Verlängerungsstrategie.
• 14:55
  Die Verlängerung erfolgt uns ein.
• 14:56
  Senden Sie mithilfe der Abonnement-ID eine Patch-Anforderung an den Abonnement-Endpunkt
• 14:59
  und aktualisieren Sie das Ablaufdatum auf ein neues Datum in der Zukunft.
• 15:02
  Dadurch wird die Lebensdauer des Abonnements verlängert.
• 15:04
  Sie können dies beliebig oft tun, solange Sie dies vor Ablauf des aktuellen Ablaufdatums tun.
• 15:09
  Microsoft Graph unterstützt Sie hier mit sogenannten Lebenszyklusbenachrichtigungen.
• 15:13
  Wenn Sie ein Abonnement erstellen, können Sie eine separate URL angeben,
• 15:15
  die als URL für Lebenszyklusbenachrichtigungen bezeichnet wird.
• 15:18
  Microsoft Graph sendet Benachrichtigungen an die URL, wenn bestimmte Dinge passieren.
• 15:22
  Beispielsweise, wenn Ihr Abonnement bald abläuft, Ihr Zugriffstoken bald abläuft
• 15:25
  oder wenn sich die Berechtigungen für Ihre App ändern.
• 15:28
  Diese Lebenszyklusbenachrichtigungen informieren Sie.
• 15:30
  Sie müssen nicht raten, wann Ihr Abonnement abläuft.
• 15:32
  Graph sagt Ihnen, Ihr Abonnement läuft in ein paar Stunden ab.
• 15:35
  Sie sollten es vielleicht verlängern.
• 15:37
  Das ist, als würden Sie von Zeitschriften Verlag eine Erinnerung erhalten,
• 15:39
  dass Ihr Abonnement bald abläuft.
• 15:41
  Sehr hilfreich, wenn Sie aufmerksam sind.
• 15:43
  Doch was passiert, wenn trotzdem etwas schief geht?
• 15:45
  Vielleicht fällt Ihr Endpunkt für eine Weile aus
• 15:46
  oder Benachrichtigungen werden gelöscht, weil Sie zu langsam waren.
• 15:49
  Was dann?
• 15:49
  Hier kommt die Delta-Abfrage ins Spiel.
• 15:51
  Die Delta-Abfrage ist ein separates Feature von Microsoft Graph,
• 15:54
  mit dem Sie fragen können,
• 15:55
  was hat sich seit meiner letzten Überprüfung geändert?
• 15:57
  Dabei werden nur die Änderungen zurückgegeben, nichts weiter.
• 15:59
  Und so funktioniert es, wenn Sie es zum ersten Mal an der Delta-Abfrage für eine Rezession.
• 16:02
  Benutzer gibt Graph alle Benutzer in Ihrem Mandanten zurück.
• 16:05
  Es wird aber noch etwas Zusätzliches zurückgegeben,
• 16:06
  ein spezieller Link, der als Delta-Link bezeichnet.
• 16:08
  Ich speichere diesen Link.
• 16:09
  Wenn Sie dieselbe Abfrage das nächste Mal ausführen,
• 16:11
  verwenden Sie diesen Delta-Link.
• 16:12
  Und anstatt erneut alle Benutzer abzurufen,
• 16:14
  erhalten Sie nur diejenigen, die sich seit ihrer letzten Abfrage geändert haben.
• 16:16
  Neue Benutzer, aktualisierte Benutzer, gelöschte Benutzer.
• 16:19
  Das alles.
• 16:20
  Stellen Sie sich vor, Sie lesen eine Liste mit Neuigkeiten,
• 16:22
  anstatt jedes Mal die gesamte Enzyklopädie zu lesen.
• 16:25
  Viel schneller, viel weniger Daten.
• 16:26
  Hier ist nun das intelligente Muster.
• 16:27
  Kombinieren Sie Webhooks mit Delta-Abfragen.
• 16:29
  Verwenden Sie Webhooks, um zu erfahren, wann sich etwas geändert hat.
• 16:31
  Und verwenden Sie dann die Delta-Abfrage, um herauszufinden, was genau sich geändert hat.
• 16:34
  Lassen Sie mich erklären, warum das wichtig ist.
• 16:35
  Webhooks sind schnell, aber nicht perfekt.
• 16:37
  Benachrichtigungen können verloren gehen, Abonnements können ablaufen und die Endpunkte kann ausfallen.
• 16:41
  Die Delta-Abfrage lässt sich durchzufüllen.
• 16:42
  Sie können sie jederzeit ausführen und erhalten eine vollständige Liste der Änderungen seit Ihrer letzten Überprüfen.
• 16:46
  Selbst wenn Sie also eine Benachrichtigung verpassen, können Sie sie nachholen.
• 16:49
  Hier ist der typische Ablauf.
• 16:51
  Richten Sie ein Webhook-Abonnement für Benutzeränderungen ein.
• 16:53
  Führen Sie eine erste Delta-Abfrage aus, um den Basisstatus abzurufen und den Delta-Link zu speichern.
• 16:57
  Wenn ein Webhook eintrifft, der Sie darüber informiert, dass sich ein Benutzer geändert hat,
• 16:59
  finden Sie eine Delta-Abfrage mit Ihrem gespeicherten Delta-Link.
• 17:02
  Dadurch erhalten Sie die genaue Änderung.
• 17:03
  Verarbeiten Sie sie und speichern Sie dann den neuen Delta-Link aus dieser Antwort.
• 17:06
  Wiederholen Sie den Vorgang, wenn das nächste Mal ein Webhook eingeht.
• 17:08
  Und wenn Sie jemals eine Benachrichtigung verpassen oder Ihr Abonnement abläuft,
• 17:11
  führen Sie die Delta-Abfrage einfach erneut aus.
• 17:14
  Sie erhalten alles, was Sie verpasst haben.
• 17:15
  Das ist ein Sicherheitsnetz.
• 17:16
  Webhooks sorgen für Geschwindigkeit und Delta-Abfragen für Zuverlässigkeit.
• 17:19
  Zusammen ergeben Sie eine leistungsstarke Kombination.
• 17:22
  Beispiel aus der Praxis und nächste Schritte.
• 17:24
  Stellen Sie sich vor, morgen tritt ein neuer Mitarbeiter in Ihr Unternehmer.
• 17:26
  Jemand aus der Personalabteilung erstellt ein Konto mit der Microsoft-Entre-ID
• 17:29
  und diese einzelne Aktion löst eine Kettenreaktion aus, löst eine Kettenreaktion aus.
• 17:33
  Wenn Sie ein Webhook-Abonnement für Benutzeränderungen eingerichtet haben,
• 17:36
  bemerkt Microsoft Graphies sofort und sendet einen Beitrag an Ihren Endpunkt.
• 17:39
  Folgendes geschieht als nächstes.
• 17:40
  Ihr Endpunkt empfängt die Benachrichtigung, überprüft den Client-Status
• 17:43
  und wenn dieser mit Ihrem Geheimnis übereinstimmt, wissen Sie, dass er legitim ist.
• 17:46
  Sie geben innerhalb von drei Sekunden die Antwort 202 akzeptiert zurück,
• 17:49
  in der die Benachrichtigung bestätigt wird.
• 17:51
  Anschließend nimmt Ihr Hintergrund-Worker Sie entgegen.
• 17:53
  Der Worker sieht, dass ein Benutzer erstellt wurde.
• 17:54
  Die Benachrichtigung enthält Sie doch nicht alle Details.
• 17:56
  Daher führt der Mithilfe aus gespeicherten Delta-Links in eine Delta-Auffrage.
• 17:59
  Dadurch werden die vollständigen Informationen des neuen Benutzers zurückgegeben.
• 18:02
  Name, E-Mail-Adresse, Abteilung, Stellenbezeichnung, Vorgesetzte, alles, was Sie benötigen.
• 18:05
  Nun verwendet Ihr Worker diese Informationen
• 18:07
  und erstellt in Ihrem externen Zeiterfassungssystem ein Konto für den neuen Mitarbeiter.
• 18:10
  Er sendet eine Willkommens-E-Mail.
• 18:12
  Er fügt den neuen Mitarbeiter den entsprechenden Verteilerlisten hinzu.
• 18:14
  All dies geschieht innerhalb von Sekunden,
• 18:15
  nachdem die Personalabteilung das Konto in Entra-ID erstellt hat.
• 18:18
  Keine Abfragen, keine manuellen Schritte, keine Verzögerung.
• 18:21
  Links über die Alternativen.
• 18:22
  Ohne Webhooks müssten Sie den Endpunkt des Benutzers alle paar Minuten abfragen.
• 18:26
  Das wären hunderte von Anfragen pro Tag.
• 18:27
  Und selbst dann kann es mehrere Minuten dauern, bis Sie den neuen Benutzer erreichen.
• 18:30
  Mit Webhooks geschieht dies sofort.
• 18:32
  Eine Benachrichtigung an der Delta-Abfrage, fertig.
• 18:34
  Das ist der wahre Wert.
• 18:35
  Ihr System wird schneller, effizienter und stößt weniger wahrscheinlich an Drosselungsgrenzen.
• 18:39
  Anstatt Graph ständig nach Updates zu fragen,
• 18:41
  lassen Sie sich von Graph benachrichtigen, wenn etwas passiert.
• 18:43
  Dies ist eine grundlegende Veränderung in der Art und Weise, wie Sie Integration erscheint.
• 18:46
  Folgendes möchte ich Sie also ausprobieren.
• 18:47
  Denken Sie an einen Prozess, den Sie derzeit abfragen.
• 18:49
  Möglicherweise prüfen Sie, ob neue E-Mails in einem freigemten Postfach vorhanden sind.
• 18:52
  Möglicherweise achten Sie auf Dateiänderungen in einer SharePoint-Bibliothek.
• 18:55
  Möglicherweise überwachen Sie Benutzer-Updates für Ihr HR-System.
• 18:57
  Könnte ein Webhook diese Abfragen ersetzen?
• 18:59
  In den meisten Fällen lautet die Antwort Ja.
• 19:01
  Und Sie müssen nicht alles neu erstellen.
• 19:02
  Vielen Dank.