Bewährte Methoden für die Verwaltung und automatische Verlängerung von Abonnements
Von Mirko Peters ·
Willkommen zu unserem umfassenden Leitfaden für die Implementierung eines robusten Lebenszyklusmanagements für Abonnements in Ihren Microsoft-365-Anwendungen. Wenn Sie jemals unerwartet…
Automatisch mit KI aus dem Originalbeitrag übersetzt. Englisches Original lesen

Willkommen zu unserem umfassenden Leitfaden für die Implementierung eines soliden Lebenszyklusmanagements für Abonnements in Ihren Microsoft 365-Anwendungen. Wenn Sie schon einmal unerwartete Ausfälle Ihrer Anwendung erlebt, wichtige Datenaktualisierungen verpasst oder mit fehlerhaften Event-Listenern zu kämpfen hatten, wissen Sie, wie entscheidend eine saubere Architektur für die Echtzeitintegration ist. In unserer aktuellen Podcast-Folge Microsoft Graph Change Notifications - Simply Explained haben wir die Grundkonzepte erläutert, mit denen Sie Ihre Apps mit der Microsoft-Cloud synchron halten. In diesem begleitenden Blogbeitrag vertiefen wir diese Prinzipien und zeigen die technischen Best Practices für automatische Verlängerungen, die Verarbeitung sicherer Payloads und die Nutzung von Delta-Abfragen, um verpasste Aktualisierungen nachzuholen.
Moderne Cloud-Anwendungen benötigen ereignisgesteuerte Architekturen, um nahtlose Benutzererlebnisse zu bieten. Traditionelles Polling verschwendet wertvolles API-Kontingent, verursacht Latenz und belastet Ihre Server unnötig. Mit Microsoft Graph Change Notifications können Ihre Anwendungen unmittelbar auf Änderungen bei Benutzern, Gruppen und Sicherheitsobjekten reagieren. Eine stabile Benachrichtigungspipeline erfordert jedoch sorgfältige Aufmerksamkeit für Abonnement-Lebenszyklen, Sicherheitsprotokolle und Fehlerbehandlung. Schauen wir uns die Mechanismen von Change Notifications an und wie Sie deren Verwaltung von Anfang bis Ende beherrschen.
Überblick über Microsoft Graph
Microsoft Graph – Überblick
Change Notifications sind eine zentrale Funktion von Microsoft Graph. Sie ermöglichen Ihren Anwendungen, Informationen über Änderungen in Microsoft 365-Diensten zu erhalten. Diese Funktion verändert, wie Sie mit Daten arbeiten, und erlaubt es Ihnen, Anwendungen zu entwickeln, die in Echtzeit auf Ereignisse reagieren. Microsoft Graph dient als Zugangspunkt zu Daten, die in Microsoft 365-Diensten gespeichert sind. Ihre eigenen Anwendungen können sich damit verbinden und diese Daten nutzen, was die Produktivität in Ihrer Organisation steigert.
Funktion
| Beschreibung | Einheitlicher Endpunkt |
|---|---|
| Einzelner Endpunkt | Die Microsoft Graph API stellt mit https://graph.microsoft.com einen einzigen Endpunkt bereit, über den Sie auf umfangreiche, personenzentrierte Daten und Erkenntnisse in der Microsoft-Cloud zugreifen können. |
| Entwickler können REST-APIs oder SDKs verwenden, um auf den Endpunkt zuzugreifen und Anwendungen zu erstellen, die auf Microsoft 365-Szenarien zugeschnitten sind. | Entwickler können REST-APIs oder SDKs verwenden, um auf den Endpunkt zuzugreifen und Anwendungen für Microsoft 365-Szenarien zu erstellen. |
Der primäre Zweck von Change Notifications besteht darin, Ihre Anwendungen in Echtzeit zu aktualisieren. Mit dieser Funktion können Sie bestimmte Ressourcen abonnieren und Benachrichtigungen erhalten, sobald relevante Änderungen auftreten. Trifft beispielsweise eine neue E-Mail ein oder wird ein Dokument in SharePoint aktualisiert, kann Ihre Anwendung sofort reagieren.
Der Hauptzweck von Change Notifications besteht darin, Ihre Anwendungen in Echtzeit zu informieren. Mit dieser Funktion abonnieren Sie bestimmte Ressourcen und erhalten eine Benachrichtigung, sobald relevante Änderungen auftreten. Trifft beispielsweise eine neue E-Mail ein oder wird ein Dokument in SharePoint aktualisiert, kann Ihre Anwendung sofort reagieren.
Echtzeitbenachrichtigungen und Webhooks ermöglichen es Ihren Anwendungen, unmittelbar auf Änderungen von Benutzerdaten zu reagieren. Diese ereignisgesteuerte Architektur steigert das Benutzerengagement, indem Anwender stets informiert sind und zeitnah reagieren können. Durch die Integration verschiedener Microsoft 365-Dienste lassen sich intelligente Workflows erstellen, die Prozesse automatisieren und die Effizienz verbessern.
Außerdem helfen Change Notifications, unnötigen API-Datenverkehr zu reduzieren. Statt regelmäßig nach Aktualisierungen zu fragen, kann Ihre Anwendung auf Änderungen warten, was die Ressourcennutzung optimiert. Diese Effizienz ist entscheidend für eine hohe Leistung, insbesondere bei Anwendungen, die große Datenmengen verarbeiten.
Ressourcentypen
Ressourcentypen
Microsoft Graph unterstützt verschiedene Ressourcentypen für Change Notifications. Wenn Sie diese Ressourcentypen kennen, können Sie Ihre Anwendungen gezielt auf Änderungen abstimmen. Dies sind die wichtigsten Ressourcentypen, mit denen Sie arbeiten können:
Benutzerbenachrichtigungen: Diese Benachrichtigungen informieren Sie über Änderungen an Benutzerkonten. Sie können beispielsweise eine Meldung erhalten, wenn ein Benutzer sein Profil aktualisiert oder sein Kennwort ändert. Diese Funktion ist für Anwendungen entscheidend, die Benutzerdaten verwalten und Echtzeit-Aktualisierungen benötigen, um die Genauigkeit zu gewährleisten.
Gruppenbenachrichtigungen: Gruppenbenachrichtigungen halten Sie über Änderungen innerhalb von Gruppen in Microsoft 365 auf dem Laufenden. Sie können Ereignisse verfolgen, etwa wenn ein Benutzer einer Gruppe beitritt oder sie verlässt. Diese Informationen sind für Anwendungen wichtig, die auf Gruppendynamiken setzen, beispielsweise Collaboration-Tools oder Software für das Projektmanagement.
Darüber hinaus unterstützen auch Microsoft Graph-Sicherheitsentitäten Änderungsbenachrichtigungen. Damit können Sie sicherheitsrelevante Änderungen überwachen und so die Fähigkeit Ihrer Anwendung stärken, auf potenzielle Bedrohungen zu reagieren.
Änderungstypen
Änderungsbenachrichtigungen lassen sich je nach Art der Änderung in drei Haupttypen unterteilen:
Erstellen
Der Änderungstyp „Erstellen“ benachrichtigt Sie, wenn eine neue Ressource angelegt wird. Erstellt ein Benutzer beispielsweise ein neues Dokument in SharePoint, kann Ihre Anwendung eine Benachrichtigung erhalten. So können Sie sofort reagieren, etwa eine Benutzeroberfläche aktualisieren oder Workflows auslösen.
Aktualisieren
Der Änderungstyp „Aktualisieren“ informiert Sie, wenn eine vorhandene Ressource geändert wird. Bearbeitet ein Benutzer etwa ein Dokument oder aktualisiert seine Profildaten, kann Ihre Anwendung entsprechend reagieren. So sehen Benutzer stets die aktuellsten Informationen, was ihr Nutzungserlebnis verbessert.
Löschen
Der Änderungstyp „Löschen“ informiert Sie, wenn eine Ressource entfernt wird. Löscht ein Benutzer eine Datei oder eine Gruppe, kann Ihre Anwendung diese Benachrichtigung erhalten. Diese Möglichkeit trägt zur Datenintegrität bei und hilft Ihnen, Ressourcen effektiv zu verwalten.
Wenn Sie diese Benachrichtigungstypen verstehen, können Sie Anwendungen entwickeln, die dynamisch auf Änderungen in den Microsoft 365-Diensten reagieren. Diese Reaktionsfähigkeit steigert nicht nur das Benutzerengagement, sondern optimiert auch die Ressourcenverwaltung.
Abonnieren von Benachrichtigungen
Das Abonnieren von Benachrichtigungen ist ein entscheidender Schritt, um Microsoft Graph-Änderungsbenachrichtigungen zu nutzen. Dieser Prozess ermöglicht es Ihrer Anwendung, Echtzeit-Updates über Änderungen in den Microsoft 365-Diensten zu erhalten. Im Folgenden erfahren Sie, wie Sie ein Abonnement effektiv erstellen und die richtigen Zustellungsoptionen wählen.
Abonnement erstellen
Das Erstellen eines Abonnements umfasst mehrere Voraussetzungen und Schritte. Befolgen Sie diese Richtlinien, damit die Einrichtung erfolgreich verläuft.
Voraussetzungen für das Abonnement
Bevor Sie ein Abonnement erstellen, stellen Sie sicher, dass Sie die folgenden technischen Voraussetzungen erfüllen:
| Voraussetzung | Beschreibung |
|---|---|
| includeResourceData | Setzen Sie den Wert auf true, um Ressourcendaten einzuschließen. Dies erfordert eine Verschlüsselung. |
| encryptionCertificate | Muss angegeben werden, damit das Erstellen des Abonnements nicht fehlschlägt, wenn includeResourceData auf „true“ gesetzt ist. |
| read-Bereich | Erforderlich zum Erstellen und Verwalten von Abonnements (Abrufen, Aktualisieren und Löschen). |
Diese Voraussetzungen stellen sicher, dass Ihr Abonnement korrekt und sicher funktioniert.
Schritte zum Erstellen eines Abonnements
Um ein Abonnement zu erstellen, gehen Sie wie folgt vor:
- Ressource definieren: Legen Sie fest, welche Microsoft Graph-Ressource Sie überwachen möchten, etwa neue E-Mails oder aktualisierte Dokumente.
- Benachrichtigungsendpunkt festlegen: Geben Sie die URL an, an die Microsoft Graph Benachrichtigungen senden soll. Stellen Sie sicher, dass dieser Endpunkt öffentlich erreichbar und mit HTTPS gesichert ist.
- Änderungstypen auswählen: Entscheiden Sie, welche Arten von Änderungen Sie abonnieren möchten, etwa Ereignisse zum Erstellen, Aktualisieren oder Löschen.
- Abonnementanforderung senden: Verwenden Sie die Microsoft Graph-API, um eine POST-Anforderung zum Erstellen des Abonnements zu senden. Fügen Sie alle erforderlichen Parameter in den Anforderungstext ein.
- Validierung des Benachrichtigungsendpunkts verarbeiten: Microsoft Graph validiert Ihren Benachrichtigungsendpunkt. Stellen Sie sicher, dass Ihr Endpunkt auf diese Validierungsanforderung antworten kann.
Wenn Sie diese Schritte befolgen, können Sie ein Abonnement erfolgreich erstellen, das Ihre Anwendung mit Echtzeit-Änderungen auf dem neuesten Stand hält.
Zustellungsoptionen
Sobald Sie ein Abonnement erstellen, müssen Sie festlegen, wie Sie Benachrichtigungen empfangen möchten. Microsoft Graph bietet zwei primäre Zustellungsoptionen: Webhooks und Azure Event Hubs.
Webhooks
Webhooks bieten eine unkomplizierte Möglichkeit, Benachrichtigungen zu empfangen. Dafür müssen Sie einen öffentlich erreichbaren, per HTTPS gesicherten Endpunkt einrichten. Hier sind einige wichtige Punkte zu Webhooks:
- Sie ermöglichen die sofortige, push-basierte Zustellung von Benachrichtigungen.
- Sie müssen die Validierung der Benachrichtigungs-URL beantworten, um zu bestätigen, dass Ihr Endpunkt aktiv ist.
- Webhooks eignen sich ideal für Anwendungen, die ohne Polling sofort aktualisiert werden müssen.
Azure Event Hubs
Azure Event Hubs ist eine weitere Option für die Verarbeitung von Benachrichtigungen, insbesondere in Szenarien mit hohem Durchsatz. Das sollten Sie wissen:
- Event Hubs benötigen keine öffentlich zugängliche Benachrichtigungs-URL.
- Sie müssen nicht auf die Validierung der Benachrichtigungs-URL reagieren.
- Diese Option erfordert die Bereitstellung eines Event Hubs und von Azure Key Vault für den sicheren Zugriff.
Die Nutzung von Azure Event Hubs kann die Skalierbarkeit und Zuverlässigkeit Ihrer Anwendung verbessern, wenn Sie große Mengen an Benachrichtigungen verarbeiten.
Benachrichtigungen verwalten
Ein effektives Verwalten Ihrer Abonnements ist entscheidend, damit der Fluss der Änderungsbenachrichtigungen erhalten bleibt. Dieser Abschnitt behandelt automatisch verlängerte Abonnements und Best Practices für die Verarbeitung von Benachrichtigungen.
Automatisch verlängerte Abonnements
Warum die automatische Verlängerung wichtig ist
Automatisch verlängerte Abonnements sind entscheidend, um eine unterbrechungsfreie Zustellung von Benachrichtigungen sicherzustellen. Indem Sie das Ablaufdatum des Abonnements automatisch verlängern, verhindern Sie Lücken, durch die keine Benachrichtigungen mehr gesendet würden. Abonnements laufen in der Regel nach drei bis sieben Tagen ab. Läuft ein Abonnement ab, werden keine Benachrichtigungen mehr zugestellt. Daher ist eine Verlängerungsstrategie unerlässlich. Sie können einen Trigger so konfigurieren, dass er nach Zeitplan ausgeführt wird und an einen Verlängerungszweig weiterleitet, der das Abonnement automatisch verlängert. Diese Methode macht manuelle Eingriffe überflüssig und stellt sicher, dass Benachrichtigungen aktiv bleiben.
Schritte für die automatische Verlängerung
Um die automatische Verlängerung für Ihre Abonnements einzurichten, gehen Sie wie folgt vor:
- Empfangen Sie ein Ereignis
microsoft.graph.subscriptionReauthorizationRequired. - Validieren Sie den Clientstatus, wenn ein Clientgeheimnis angegeben wurde.
- Stellen Sie sicher, dass ein gültiges Zugriffstoken verfügbar ist.
- Rufen Sie die API
/reauthorizeauf, um die Autorisierung ohne Verlängerung des Ablaufdatums zu erneuern, oder verwenden Sie die MethodePATCH, um das Abonnement zu verlängern und neu zu autorisieren.
Wenn Sie diese Schritte befolgen, behalten Sie die kontinuierliche Überwachung im Blick und stellen sicher, dass Ihre Anwendung rechtzeitig Updates erhält.
Benachrichtigungen verarbeiten
Eine effiziente Verarbeitung von Benachrichtigungen ist der Schlüssel, um die Microsoft Graph Change Notifications optimal zu nutzen. Diese Best Practices sollten Sie berücksichtigen:
Umgang mit Benachrichtigungs-Payloads
Beim Umgang mit Benachrichtigungs-Payloads sollten Sie den Fokus auf Datenintegrität und Sicherheit legen. Diese grundlegenden Praktiken sind essenziell:
- Speichern Sie API-Schlüssel und Token in Konfigurationsvariablen oder Geheimnissen, statt sie fest im Code zu hinterlegen.
- Stellen Sie Verbindungen zu APIs immer über HTTPS her, um Daten während der Übertragung zu verschlüsseln.
- Rotieren Sie Anmeldedaten regelmäßig gemäß den Empfehlungen des API-Anbieters.
- Validieren Sie SSL-Zertifikate, um sichere Verbindungen zu gewährleisten.
- Bereinigen und validieren Sie alle Benutzereingaben, um Injection-Angriffe zu verhindern.
Diese Praktiken helfen Ihnen, eine sichere Umgebung bei der Verarbeitung von Benachrichtigungen aufrechtzuerhalten.
Best Practices
Für eine effektive Verarbeitung eingehender Benachrichtigungen sollten Sie die folgenden Best Practices berücksichtigen:
- Reagieren Sie schnell auf Benachrichtigungen und antworten Sie innerhalb von 30 Sekunden.
- Validieren Sie den
clientState, um sicherzustellen, dass die Benachrichtigungen von Microsoft Graph stammen. - Behandeln Sie Wiederholungsversuche sorgfältig, da Microsoft Graph fehlgeschlagene Zustellungen erneut versucht.
- Überwachen Sie das Ablaufdatum von Abonnements und verlängern Sie sie, bevor sie ablaufen.
- Verwenden Sie Delta-Abfragen, um bestimmte Änderungen zu identifizieren, auf die die Benachrichtigungen hinweisen.
Mit diesen Strategien steigern Sie die Reaktionsfähigkeit und Zuverlässigkeit Ihrer Anwendung beim Umgang mit Änderungsbenachrichtigungen.
Häufige Herausforderungen
Fehlerbehebung
Bei der Nutzung der Microsoft Graph Change Notifications können verschiedene Herausforderungen auftreten. Zu den häufigsten Problemen zählen fehlgeschlagene Benachrichtigungen, ungültige Callbacks und verpasste Updates. Um diese Probleme zu lösen, gehen Sie wie folgt vor:
- Warten Sie die im Header
Retry-Afterangegebene Dauer ab. - Wiederholen Sie die Anfrage.
- Wenn die Anforderung erneut mit dem Fehlercode 429 fehlschlägt, verwenden Sie weiterhin die Verzögerung aus
Retry-Afterund wiederholen Sie die Anforderung, bis sie erfolgreich ist.
Wenn Sie diese Schritte befolgen, können Sie viele häufige Probleme bei Änderungsbenachrichtigungen wirksam beheben.
Zustellung sicherstellen
Eine zuverlässige Zustellung von Microsoft Graph Change Notifications ist entscheidend für die Leistung Ihrer Anwendung. Hier sind einige Methoden, mit denen Sie die Zustellung von Benachrichtigungen verbessern können:
- Azure Event Hubs: Dieser Dienst verarbeitet große Mengen an Benachrichtigungen, speichert Nachrichten zur Verarbeitung und ermöglicht die erneute Wiedergabe von Nachrichten im Fehlerfall. Er wird besonders für Szenarien mit hohem Durchsatz empfohlen.
- NGINX Reverse Proxy mit IP-Zulassungsliste: Diese Konfiguration bietet starke Sicherheit, indem sie den Zugriff auf bekannte IP-Bereiche beschränkt. So stellen Sie sicher, dass nur Microsoft Graph Ihren Webhook erreichen kann. Die Kombination aus IP-Filterung und clientState-Überprüfung bietet eine zusätzliche Sicherheitsebene.
Um die Zustellung zusätzlich abzusichern, sollten Sie folgende bewährte Methoden berücksichtigen:
- Antworten auf Webhook-Benachrichtigungen: Antworten Sie immer sofort mit
200 OKoder202 Accepted, um Verzögerungen bei der Verarbeitung von Benachrichtigungen zu vermeiden. - Überwachung von Abonnements: Prüfen und verlängern Sie Ihre Abonnements regelmäßig, damit sie nicht unbemerkt ablaufen. Dieser proaktive Ansatz sorgt für einen stetigen Fluss von Benachrichtigungen.
- Verwendung von Delta-Abfragen: Implementieren Sie Delta-Abfragen, um verpasste Nachrichten abzugleichen. Diese Methode ermöglicht es Ihnen, Änderungen nachzuholen, die eingetreten sind, während Ihre Anwendung keine Benachrichtigungen empfangen konnte.
Mit diesen Strategien erhöhen Sie die Zuverlässigkeit Ihrer Microsoft Graph Change Notifications und stellen sicher, dass Ihre Anwendung zuverlässig auf Änderungen in Microsoft 365-Diensten reagiert.
Zusammengefasst ermöglichen Ihnen Microsoft Graph Change Notifications, reaktionsschnelle Anwendungen zu entwickeln, die auf Echtzeitereignisse in Microsoft 365 reagieren. Durch das Abonnieren von Benachrichtigungen können Sie Prozesse automatisieren, Benutzererfahrungen verbessern und die Effizienz in Ihrer Organisation steigern. Setzen Sie die in diesem Blog beschriebenen Schritte um, um Benachrichtigungen effektiv zu verwalten.
Behalten Sie diese zentralen Punkte für Ihr Unternehmen im Blick:
- Automatisierung mit Microsoft Graph spart Zeit und ermöglicht es Ihrem Team, sich auf wichtige Projekte zu konzentrieren.
- Einheitliche Verwaltung über Microsoft 365-Dienste hinweg reduziert Fehler und steigert die Effizienz.
- Die Automatisierung von Onboarding und Offboarding von Benutzern hilft, Sicherheit und Compliance zu wahren.
Zur weiteren Vertiefung finden Sie hier passende Ressourcen:
| Ressource | Beschreibung |
|---|---|
| changeNotification resource type | Stellt die Benachrichtigung dar, die an den Abonnenten (App) eines Microsoft Graph-Abonnements gesendet wird. Alle Eigenschaften dieser Ressource sind schreibgeschützt. |
| Änderungsbenachrichtigungen für Microsoft Teams-Ressourcen | Änderungsbenachrichtigungen für Microsoft Teams-Ressourcen mithilfe von Microsoft Graph ermöglichen es Ihnen, Änderungen an einer Ressource zu abonnieren. |
Bleiben Sie über neue Funktionen und bewährte Methoden auf dem Laufenden, indem Sie das Microsoft 365-Nachrichtencenter und die Microsoft 365-Roadmap verfolgen. Für eine vertiefte Diskussion und architektonische Einblicke zu diesem Thema hören Sie sich unbedingt unsere zugehörige Folge an: Microsoft Graph Change Notifications - Simply Explained.
Häufige Fragen
Was sind Microsoft Graph Change Notifications?
Microsoft Graph Change Notifications ermöglichen es Ihren Anwendungen, in Echtzeit Aktualisierungen über Änderungen in Microsoft 365-Diensten zu erhalten. Sie können bestimmte Ressourcen abonnieren und werden sofort benachrichtigt, wenn Änderungen auftreten.
Wie erstelle ich ein Abonnement für Benachrichtigungen?
Um ein Abonnement zu erstellen, bestimmen Sie die zu überwachende Ressource, legen den Benachrichtigungsendpunkt fest, wählen die Änderungstypen aus und senden eine POST-Anforderung an die Microsoft Graph API.
Welche Zustelloptionen gibt es für Benachrichtigungen?
Sie können Benachrichtigungen über Webhooks oder Azure Event Hubs empfangen. Webhooks liefern sofortige Push-Benachrichtigungen, während Azure Event Hubs große Mengen an Benachrichtigungen effizient verarbeiten.
Wie lange sind Abonnements gültig?
Abonnements haben in der Regel eine Laufzeit von drei bis sieben Tagen. Sie müssen sie vor Ablauf erneuern, damit die Benachrichtigungen kontinuierlich zugestellt werden.
Was sollte ich tun, wenn ich eine Benachrichtigung verpasse?
Wenn Sie eine Benachrichtigung verpassen, verwenden Sie Delta-Abfragen, um die Änderungen zu ermitteln und abzurufen, die im verpassten Zeitraum aufgetreten sind. So holen Sie Aktualisierungen nach.
Wie stelle ich eine zuverlässige Zustellung von Benachrichtigungen sicher?
Für eine zuverlässige Zustellung reagieren Sie zeitnah auf Benachrichtigungen, überwachen das Ablaufdatum Ihrer Abonnements und ziehen für Szenarien mit hohem Durchsatz Azure Event Hubs in Betracht.
Welche typischen Herausforderungen gibt es bei Change Notifications?
Zu den häufigen Herausforderungen gehören fehlgeschlagene Benachrichtigungen, ungültige Callbacks und verpasste Aktualisierungen. Sie können diese Probleme beheben, indem Sie bestimmte Schritte befolgen, etwa Anfragen erneut senden und die Gültigkeit Ihres Endpunkts prüfen.
Wo finde ich weitere Ressourcen zu Microsoft Graph Change Notifications?
Die offizielle Microsoft-Dokumentation zu Change Notifications und die Ressourcen zu Microsoft Teams bieten detaillierte Informationen und Best Practices für die Umsetzung.
🎧 Das sollten Sie auch hören
- Microsoft Graph Connectors – Simply Explained bietet den nächsten praktischen Lernschritt und liefert nützlichen Kontext zu diesem Thema.
- AI Agents – Simply Explained bietet den nächsten praktischen Lernschritt und liefert nützlichen Kontext zu diesem Thema.
Zuletzt überprüft: Juli 2026.