Knopmigratie van REST API naar Graph API

Algemene informatie over de migratie

Zoals aangekondigd in november 2021, zal REST API volledig worden stopgezet door Microsoft in november 2022 wereldwijd voor alle klanten die gebruikmaken van Microsoft Exchange Online.

Dit betekent dat we zullen overstappen naar Graph API, en we verzoeken alle klanten die gebruikmaken van Microsoft Exchange Online (Cloud, MS356) om over te schakelen van REST API naar Graph API, indien mogelijk, om dezelfde functionaliteiten van de Phishing Report Button te blijven bieden.

Van Microsoft: https://docs.microsoft.com/en-us/previous-versions/office/office-365-api/api/version-2.0/use-outlook-rest-api

Wat is Graph API?

Graph API is een RESTful API die door Microsoft is ontwikkeld en de nieuwe manier is om te communiceren met Microsoft 365-services. Het werkt op dezelfde manier als REST API, maar voegt een extra laag van authenticatie en autorisatie toe.

Wat betekent dit?

• Dit betekent dat alles wat u als applicatie kunt doen, gebaseerd is op de interactie van de gebruiker met de applicatie. Dit geeft meer controle in handen van de gebruiker, de Admin en het bedrijf.

• Houd er echter rekening mee dat Graph API alleen beschikbaar is voor MS365-gebruikers, en niet-MS365-gebruikers kunnen geen gebruik maken van Graph API.

Van Microsoft: https://docs.microsoft.com/en-us/graph/overview

Wie moet migreren naar Graph API?

Exchange online (MS365)

Voor elke klant die de cloudoplossingen van Exchange Online gebruikt in combinatie met een Microsoft 365-abonnement, wordt het sterk aanbevolen om vóór november 2022 over te stappen naar Graph API. De Phishing Report Button zal niet langer in staat zijn om e-mailinformatie weer te geven via de REST API. Als alternatief kunnen klanten, afhankelijk van uw configuratie, nog steeds terugvallen op EWS API indien nodig. Dit wordt echter niet aanbevolen, omdat dit de functionaliteit van de Phishing Report Button zal beperken. Raadpleeg onze bijgewerkte compatibiliteitsmatrix voor Outlook-client en server-API hier om te controleren of u de juiste API kiest op basis van uw configuratie.

Exchange On-Premises hybride implementaties

Klanten die gebruikmaken van een hybride configuratie (Microsoft 365 + Exchange On-Premises) kunnen REST API gebruiken tot juni 2023. Daarna worden alle REST API-verzoeken geblokkeerd door Microsoft, en we verzoeken u contact op te nemen met Microsoft voor verdere stappen omtrent de migratie.

Raadpleeg hier onze bijgewerkte compatibiliteit van de Outlook-client en server-API: Compatibiliteit van de Outlook-client en server-API van de Phishing Report Button

Van Microsoft: De Outlook REST API gebruiken (versie 2.0):https://docs.microsoft.com/en-us/graph/hybrid-rest-support

Aanbevolen: We raden klanten sterk aan contact op te nemen met Microsoft-ondersteuning om correct te kunnen doorgaan en te migreren op basis van hun configuratie.

Hoe migreert u de Phishing Report Button naar Graph API?

Stappen voor migratie:

1. Download het nieuwe Graph-manifestbestand vanuit de Phishing Report Button-instellingen van de Manager.

   • Phishing Report Button / Microsoft Integrations / Phishing Report Button manifest

   • Selecteer de omgeving die u gebruikt.

   • Klik op Download manifest file om het bestand te downloaden.

2. Werk de Phishing Report Button bij met het Graph-manifestbestand.

3. Tijdens de installatie moeten machtigingen worden verleend voor de gevraagde scopes van de Phishing Report Button-applicatie. We raden aan om vooraf machtigingen te verlenen voor alle gebruikers, anders moet elke gebruiker na de update afzonderlijk toestemming verlenen door zijn of haar inloggegevens in te voeren.

4. Na de installatie van het Graph-manifest raden we aan 24 uur te wachten totdat de update is uitgerold naar alle tenant-gebruikers.

5. Activeer tot slot de Graph API in de Manager onder de Phishing Report Button-instellingen.

   • Phishing Report Button > Email Integrations > Microsoft API

Verandert er iets voor eindgebruikers?

Er verandert niets voor eindgebruikers.

Zodra de overgang naar Graph API is voltooid, zullen gebruikers geen verschil merken in het gebruik van de Phishing Report Button, omdat de gebruikersstroom en functionaliteit hetzelfde blijven.

Moet de Phishing Simulation worden onderbroken?

Tijdens het migratieproces hoeft de Phishing Simulation niet te worden onderbroken, omdat het overschakelen naar Graph API slechts een kwestie van minuten is.

Worden EWS en RestAPI nog steeds ondersteund?

Houd er rekening mee dat Microsoft de functionaliteit van RestAPI en EWS beperkt en/of stopzet. Op basis van deze beperking werkt de Phishing Report Button mogelijk niet meer correct in Cloud- en hybride configuraties. Daarom ondersteunt de Phishing Report Button EWS en RestAPI niet meer volledig.