M365Con 2027 – gratis online conferentie · 11–22 Jan 2027 · 120 sessions→ m365con.net

Blog · Mirko Peters

Best practices voor het beheren en automatisch verlengen van abonnementen

By ·

Welkom bij onze uitgebreide gids over het implementeren van een robuust beheer van de levenscyclus van abonnementen voor je Microsoft 365-applicaties. Als je ooit onverwachte…

Automatically translated with AI from the original post. Read the English original

Cover: Microsoft Graph Change Notifications - Simply Explained

Welkom bij onze uitgebreide gids over het opzetten van een robuust beheer van de levenscyclus van abonnementen voor je Microsoft 365-applicaties. Als je ooit onverwachte downtime van een applicatie hebt meegemaakt, kritieke gegevensupdates bent misgelopen of problemen had met kapotte event listeners, weet je hoe belangrijk het is om je realtime integratiearchitectuur goed in te richten. In onze recente podcastaflevering, Microsoft Graph Change Notifications - Simply Explained, hebben we de kernconcepten besproken van het synchroon houden van je apps met de Microsoft-cloud. In deze bijbehorende blogpost gaan we die principes verder uitwerken door dieper in te gaan op de technische best practices voor het instellen van automatische verlengingen, het veilig verwerken van payloads en het gebruik van delta queries om gemiste updates op te halen.

Moderne cloudapplicaties hebben event-driven architecturen nodig om naadloze gebruikerservaringen te leveren. Vertrouwen op traditionele polling-methoden verspilt waardevolle API-quota, introduceert vertraging en legt onnodige belasting op je servers. Door gebruik te maken van Microsoft Graph change notifications kunnen je applicaties direct reageren op wijzigingen in gebruikers, groepen en beveiligingsentiteiten. Het onderhouden van een waterdichte notificatiepijplijn vereist echter zorgvuldige aandacht voor de levenscycli van abonnementen, beveiligingsprotocollen en foutafhandelingsstrategieën. Laten we de werking van change notifications verkennen en hoe je het beheer ervan van begin tot eind onder de knie krijgt.

Overzicht van Microsoft Graph

Overzicht van Microsoft Graph

Change notifications zijn een belangrijke functie van Microsoft Graph. Ze stellen je applicaties in staat om updates te ontvangen over wijzigingen in Microsoft 365-diensten. Deze mogelijkheid verandert de manier waarop je met gegevens werkt, en maakt het mogelijk applicaties te bouwen die in realtime op gebeurtenissen reageren. Microsoft Graph fungeert als toegangspoort tot gegevens die zijn opgeslagen in Microsoft 365-diensten. Het stelt je eigen applicaties in staat om met deze gegevens te verbinden, wat de productiviteit van de organisatie vergroot.

Kenmerk

BeschrijvingSingle Endpoint
Eén endpointDe Microsoft Graph API biedt één endpoint, https://graph.microsoft.com, voor toegang tot rijke, people-centric gegevens en inzichten in de Microsoft-cloud.
Ontwikkelaars kunnen REST-API's of SDK's gebruiken om het endpoint te benaderen en applicaties te bouwen die zijn afgestemd op Microsoft 365-scenario's.Ontwikkelaars kunnen REST-API's of SDK's gebruiken om het endpoint te benaderen en applicaties te bouwen die zijn afgestemd op Microsoft 365-scenario's.

Het belangrijkste doel van change notifications is het leveren van realtime updates aan je applicaties. Met deze functie kun je je abonneren op specifieke resources en een melding ontvangen zodra relevante wijzigingen optreden. Als er bijvoorbeeld een nieuwe e-mail binnenkomt of een document in SharePoint wordt bijgewerkt, kan je applicatie er meteen op reageren.

Het belangrijkste doel van change notifications is je applicaties realtime updates te geven. Met deze functie abonneer je je op specifieke resources en ontvang je een melding zodra relevante wijzigingen plaatsvinden. Als er bijvoorbeeld een nieuwe e-mail binnenkomt of een document in SharePoint wordt bijgewerkt, kan je applicatie direct reageren.

Realtime notificaties en webhooks stellen je applicaties in staat direct te reageren op wijzigingen in gebruikersgegevens. Deze event-driven architectuur verhoogt de gebruikersbetrokkenheid doordat gebruikers op de hoogte blijven van wijzigingen en er op kunnen inspelen. Door verschillende Microsoft 365-diensten te integreren, kun je intelligente workflows maken die processen automatiseren en de efficiëntie verbeteren.

Bovendien helpen change notifications onnodig API-verkeer te beperken. In plaats van periodiek om updates te vragen, kan je applicatie naar wijzigingen luisteren, wat het gebruik van resources optimaliseert. Deze efficiëntie is cruciaal voor het behouden van hoge prestaties, vooral in applicaties die grote hoeveelheden gegevens verwerken.

Resourcetypen

Resourcetypen

Microsoft Graph ondersteunt verschillende resourcetypen voor change notifications. Inzicht in deze resourcetypen helpt je je applicaties zo in te richten dat ze effectief op wijzigingen reageren. Dit zijn de belangrijkste resourcetypen waarmee je kunt werken:

  • Gebruikersmeldingen: Deze meldingen informeren je over wijzigingen in gebruikersaccounts. Zo krijg je bijvoorbeeld een melding wanneer een gebruiker zijn profiel bijwerkt of zijn wachtwoord wijzigt. Dit is essentieel voor toepassingen die gebruikersgegevens beheren en realtime updates nodig hebben om de juistheid te waarborgen.

  • Groepsmeldingen: Groepsmeldingen houden je op de hoogte van wijzigingen binnen groepen in Microsoft 365. Je kunt gebeurtenissen volgen, zoals wanneer een gebruiker een groep verlaat of er lid van wordt. Deze informatie is van groot belang voor toepassingen die afhankelijk zijn van groepsdynamiek, zoals samenwerkingstools of projectmanagementsoftware.

Daarnaast ondersteunen beveiligingsentiteiten van Microsoft Graph eveneens wijzigingsmeldingen. Zo kun je beveiligingsgerelateerde wijzigingen monitoren, waardoor je toepassing beter kan reageren op mogelijke dreigingen.

Soorten wijzigingen

Wijzigingsmeldingen zijn op basis van de aard van de wijziging in drie hoofdtypen in te delen:

Create

Het create-type meldt je wanneer een nieuwe resource is aangemaakt. Als een gebruiker bijvoorbeeld een nieuw document maakt in SharePoint, kan je toepassing een melding ontvangen. Zo kun je meteen actie ondernemen, zoals een gebruikersinterface bijwerken of een workflow starten.

Update

Het update-type waarschuwt je wanneer een bestaande resource wordt gewijzigd. Als een gebruiker bijvoorbeeld een document bewerkt of zijn profielgegevens bijwerkt, kan je toepassing daar passend op reageren. Zo zien gebruikers altijd de meest actuele informatie, wat hun ervaring verbetert.

Delete

Het delete-type informeert je wanneer een resource wordt verwijderd. Als een gebruiker een bestand of een groep verwijdert, kan je toepassing deze melding ontvangen. Deze mogelijkheid helpt de gegevensintegriteit te bewaken en stelt je in staat resources effectief te beheren.

Door deze typen meldingen te begrijpen, kun je toepassingen bouwen die dynamisch reageren op wijzigingen in Microsoft 365-diensten. Deze responsiviteit verbetert niet alleen de betrokkenheid van gebruikers, maar optimaliseert ook het beheer van resources.

Abonneren op meldingen

Abonneren op meldingen is een cruciale stap om gebruik te maken van Microsoft Graph-wijzigingsmeldingen. Dit proces stelt je toepassing in staat realtime updates te ontvangen over wijzigingen in Microsoft 365-diensten. Hier lees je hoe je effectief een abonnement aanmaakt en de juiste bezorgopties kiest.

Een abonnement aanmaken

Het aanmaken van een abonnement vraagt om een aantal voorwaarden en stappen. Volg deze richtlijnen om een succesvolle configuratie te realiseren.

Vereisten voor het abonnement

Voordat je een abonnement aanmaakt, moet je aan de volgende technische vereisten voldoen:

VereisteBeschrijving
includeResourceDataZet dit op true om resourcegegevens mee te sturen; dit vereist versleuteling.
encryptionCertificateMoet worden opgegeven om te voorkomen dat het aanmaken van het abonnement mislukt wanneer includeResourceData op true staat.
read-scopeVereist voor het aanmaken en beheren van abonnementen (ophalen, bijwerken en verwijderen).

Deze vereisten zorgen ervoor dat je abonnement correct en veilig werkt.

Stappen om een abonnement aan te maken

Om een abonnement aan te maken, volg je deze stappen:

  1. De resource bepalen: Bepaal welke Microsoft Graph-resource je wilt monitoren, zoals nieuwe e-mails of gewijzigde documenten.
  2. Het meldingseindpunt instellen: Geef de URL op waarnaar Microsoft Graph meldingen stuurt. Zorg dat dit eindpunt publiek toegankelijk is en beveiligd met HTTPS.
  3. Wijzigingstypen kiezen: Bepaal welke soorten wijzigingen je wilt volgen, zoals create-, update- of delete-gebeurtenissen.
  4. Het abonnementsverzoek versturen: Gebruik de Microsoft Graph API om met een POST-verzoek het abonnement aan te maken. Neem alle benodigde parameters op in de requestbody.
  5. Validatie van het meldingseindpunt afhandelen: Microsoft Graph valideert je meldingseindpunt. Zorg dat je eindpunt op dit validatieverzoek kan reageren.

Door deze stappen te volgen, maak je succesvol een abonnement aan dat je toepassing up-to-date houdt met wijzigingen in realtime.

Bezorgopties

Zodra je een abonnement aanmaakt, moet je kiezen hoe je meldingen ontvangt. Microsoft Graph biedt twee belangrijke leveringsopties: webhooks en Azure Event Hubs.

Webhooks

Webhooks zijn een eenvoudige manier om meldingen te ontvangen. Je hebt er een publiek toegankelijk, via HTTPS beveiligd eindpunt voor nodig. Dit zijn de belangrijkste punten over webhooks:

  • Ze maken directe, push-gebaseerde levering van meldingen mogelijk.
  • Je moet reageren op de validatie van de meldings-URL om te bevestigen dat je eindpunt actief is.
  • Webhooks zijn ideaal voor applicaties die direct updates nodig hebben zonder te hoeven pollen.

Azure Event Hubs

Azure Event Hubs is een andere optie voor het verwerken van meldingen, vooral in scenario's met een hoge doorvoer. Dit moet je weten:

  • Event Hubs vereisen geen publiek toegankelijke meldings-URL.
  • Je hoeft niet te reageren op de validatie van de meldings-URL.
  • Deze optie vereist het inrichten van een event hub en Azure Key Vault voor veilige toegang.

Het gebruik van Azure Event Hubs kan de schaalbaarheid en betrouwbaarheid van je applicatie verbeteren wanneer je grote volumes meldingen verwerkt.

Meldingen beheren

Het effectief beheren van je abonnementen is cruciaal om de stroom van wijzigingsmeldingen in stand te houden. Dit onderdeel behandelt automatisch verlengende abonnementen en best practices voor het verwerken van meldingen.

Automatisch verlengende abonnementen

Het belang van automatische verlenging

Automatisch verlengende abonnementen spelen een essentiële rol bij het zonder onderbreking leveren van meldingen. Door de vervaldatum van het abonnement automatisch te verlengen, voorkom je een gat waardoor er geen meldingen meer worden verzonden. Abonnementen duren doorgaans drie tot zeven dagen. Als een abonnement verloopt, stoppen de meldingen. Een verlengstrategie is daarom noodzakelijk. Je kunt een trigger instellen die volgens schema wordt uitgevoerd en naar een verlengtak gaat, die het abonnement automatisch verlengt. Zo is er geen handmatige tussenkomst meer nodig en blijven meldingen actief.

Stappen voor automatische verlenging

Volg deze stappen om automatische verlenging voor je abonnementen in te stellen:

  1. Ontvang een microsoft.graph.subscriptionReauthorizationRequired-gebeurtenis.
  2. Valideer de clientstatus als er een clientgeheim is opgegeven.
  3. Zorg dat er een geldig toegangstoken beschikbaar is.
  4. Roep de /reauthorize-API aan om opnieuw te autoriseren zonder de vervaldatum te verlengen, of gebruik de PATCH-methode om het abonnement te verlengen en opnieuw te autoriseren.

Door deze stappen te volgen, zorg je voor doorlopende monitoring en ontvang je applicatie tijdig updates.

Meldingen verwerken

Meldingen efficiënt verwerken is essentieel om optimaal gebruik te maken van Microsoft Graph Change Notifications. Dit zijn enkele best practices om rekening mee te houden:

Omgaan met meldingspayloads

Bij het verwerken van meldingspayloads draait het om gegevensintegriteit en beveiliging. Dit zijn de belangrijkste praktijken:

  • Sla API-sleutels en tokens op in configuratievariabelen of geheimen in plaats van ze hardcoded in je code op te nemen.
  • Maak altijd via HTTPS verbinding met API's om gegevens tijdens het transport te versleutelen.
  • Roteer credentials regelmatig, conform de aanbevelingen van de API-provider.
  • Valideer SSL-certificaten om veilige verbindingen te garanderen.
  • Saneer en valideer alle gebruikersinvoer om injectieaanvallen te voorkomen.

Deze praktijken helpen je om een veilige omgeving te behouden bij het verwerken van meldingen.

Best practices

Houd bij het effectief verwerken van binnenkomende meldingen rekening met de volgende best practices:

  • Reageer snel op meldingen, binnen 30 seconden.
  • Valideer de clientState om te bevestigen dat meldingen afkomstig zijn van Microsoft Graph.
  • Verwerk nieuwe pogingen zorgvuldig, want Microsoft Graph probeert mislukte leveringen opnieuw.
  • Houd de vervaldatum van abonnementen in de gaten en verleng ze voordat ze verlopen.
  • Gebruik delta-query's om specifieke wijzigingen te achterhalen waarop meldingen wijzen.

Met deze strategieën verhoog je de responsiviteit en betrouwbaarheid van je applicatie bij het verwerken van wijzigingsmeldingen.

Veelvoorkomende uitdagingen

Problemen oplossen

Bij het gebruik van Microsoft Graph Change Notifications kun je verschillende uitdagingen tegenkomen. Veelvoorkomende problemen zijn mislukte meldingen, ongeldige callbacks en gemiste updates. Volg deze stappen om die problemen op te lossen:

  1. Wacht de tijd die is opgegeven in de Retry-After-header.
  2. Probeer het verzoek opnieuw.
  3. Als de aanvraag opnieuw mislukt met foutcode 429, blijf dan de vertraging in Retry-After gebruiken en probeer het opnieuw totdat het lukt.

Door deze stappen te volgen, los je veel voorkomende problemen met wijzigingsmeldingen effectief op.

Zorgen voor levering

Het zorgen voor betrouwbare levering van Microsoft Graph-wijzigingsmeldingen is cruciaal voor de prestaties van je applicatie. Hier zijn enkele methoden om de levering van meldingen te verbeteren:

  • Azure Event Hubs: Deze service verwerkt grote volumes meldingen, bewaart berichten voor verwerking en maakt het mogelijk om berichten opnieuw af te spelen bij een storing. Het wordt vooral aanbevolen voor scenario's met een hoge doorvoer.
  • NGINX Reverse Proxy met IP-whitelisting: Deze opzet biedt sterke beveiliging door de toegang te beperken tot bekende IP-bereiken. Zo kan alleen Microsoft Graph je webhook bereiken. Het combineren van IP-filtering met clientState-verificatie voegt een extra beveiligingslaag toe.

Om de levering verder te waarborgen, kun je deze best practices overwegen:

  • Reageren op webhookmeldingen: Reageer altijd direct met 200 OK of 202 Accepted om vertragingen in de verwerking van meldingen te voorkomen.
  • Abonnementen bewaken: Controleer en verleng je abonnementen regelmatig om stilzwijgend verlopen te voorkomen. Deze proactieve aanpak zorgt voor een gestage stroom van meldingen.
  • Deltaquery's gebruiken: Implementeer deltaquery's om eventuele gemiste berichten alsnog op te halen. Deze methode laat je wijzigingen inhalen die zijn opgetreden terwijl je applicatie geen meldingen kon ontvangen.

Door deze strategieën toe te passen, vergroot je de betrouwbaarheid van je Microsoft Graph-wijzigingsmeldingen en blijft je applicatie reageren op wijzigingen in Microsoft 365-diensten.


Kortom, Microsoft Graph-wijzigingsmeldingen stellen je in staat om responsieve applicaties te bouwen die reageren op realtime gebeurtenissen in Microsoft 365. Door je te abonneren op meldingen kun je processen automatiseren, gebruikerservaringen verbeteren en de efficiëntie binnen je organisatie verhogen. Voer de stappen uit deze blog uit om meldingen effectief te beheren.

Overweeg deze belangrijkste punten voor je organisatie:

  • Automatisering met Microsoft Graph bespaart tijd, zodat je team zich kan richten op belangrijke projecten.
  • Consistent beheer van Microsoft 365-diensten vermindert fouten en verhoogt de efficiëntie.
  • Het automatiseren van onboarding en offboarding van gebruikers helpt de beveiliging en compliance te waarborgen.

Voor verdere verdieping kun je deze bronnen bekijken:

BronBeschrijving
changeNotification resource typeVertegenwoordigt de melding die wordt verzonden naar de abonnee (app) van een Microsoft Graph-abonnement. Alle eigenschappen van deze resource zijn alleen-lezen.
Wijzigingsmeldingen voor Microsoft Teams-resourcesMet wijzigingsmeldingen voor Microsoft Teams-resources via Microsoft Graph kun je je abonneren op wijzigingen in een resource.

Blijf op de hoogte van nieuwe functies en best practices door het Berichtencentrum en de Microsoft 365 Roadmap te volgen. Voor een diepgaandere bespreking en architectuurinzichten over dit onderwerp kun je onze bijbehorende aflevering beluisteren: Microsoft Graph Change Notifications - Simply Explained.

Veelgestelde vragen

Wat zijn Microsoft Graph-wijzigingsmeldingen?

Met Microsoft Graph-wijzigingsmeldingen ontvangen je applicaties realtime updates over wijzigingen in Microsoft 365-diensten. Je kunt je abonneren op specifieke resources en direct een melding krijgen zodra er iets verandert.

Hoe maak ik een abonnement voor meldingen aan?

Om een abonnement aan te maken, bepaal je welke resource je wilt bewaken, stel je het meldingseindpunt in, kies je de wijzigingstypen en stuur je een POST-aanvraag naar de Microsoft Graph API.

Welke leveringsopties zijn er voor meldingen?

Je kunt meldingen ontvangen via webhooks of Azure Event Hubs. Webhooks zorgen voor directe pushmeldingen, terwijl Azure Event Hubs grote volumes meldingen efficiënt verwerkt.

Hoe lang blijven abonnementen geldig?

Abonnementen blijven doorgaans drie tot zeven dagen geldig. Je moet ze vóór het verlopen verlengen om een doorlopende levering van meldingen te garanderen.

Wat moet ik doen als ik een melding mis?

Als je een melding mist, gebruik je delta-query's om de wijzigingen op te sporen en op te halen die in de gemiste periode zijn aangebracht. Zo haal je updates alsnog in.

Hoe zorg ik voor betrouwbare levering van meldingen?

Om een betrouwbare levering te garanderen, reageer je snel op meldingen, houd je de verloopdatum van abonnementen in de gaten en overweeg je Azure Event Hubs te gebruiken voor scenario's met een hoge doorvoer.

Wat zijn de veelvoorkomende uitdagingen bij wijzigingsmeldingen?

Veelvoorkomende uitdagingen zijn mislukte meldingen, ongeldige callbacks en gemiste updates. Je kunt deze problemen oplossen door specifieke stappen te volgen, zoals het opnieuw proberen van aanvragen en het controleren van de geldigheid van je endpoint.

Waar vind ik meer informatie over Microsoft Graph-wijzigingsmeldingen?

Je kunt de officiële Microsoft-documentatie over wijzigingsmeldingen en de resources voor Microsoft Teams raadplegen. Deze bronnen bieden diepgaande informatie en best practices voor implementatie.


🎧 Luister ook eens naar

Laatst beoordeeld: juli 2026.

Entities in this article

Change notifications and webhooks Microsoft Graph Azure Event Hubs React Microsoft 365 Microsoft SharePoint Event-driven architecture Microsoft Places

Related articles

RSS