Migration des boutons de REST API vers Graph API

Informations générales sur la migration

Comme annoncé en novembre 2021, l'API REST sera entièrement désactivée par Microsoft en novembre 2022 à l'échelle mondiale pour tous les clients utilisant Microsoft Exchange Online.

Cela signifie que nous allons migrer vers Graph API, et nous demandons à tous les clients utilisant Microsoft Exchange Online (Cloud, MS365) de passer de l'API REST à la Graph API si possible, afin de continuer à offrir les mêmes fonctionnalités du Bouton d'alerte phishing.

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

Qu'est-ce que la Graph API ?

La Graph API est une API RESTful développée par Microsoft et constitue la nouvelle méthode de communication avec les services Microsoft 365. Elle fonctionne de la même manière que l'API REST, mais ajoute une couche supplémentaire d'authentification et d'autorisation.

Qu'est-ce que cela signifie ?

• Cela signifie que tout ce qu'une application peut faire repose sur l'interaction de l'utilisateur avec celle-ci. Cela donne davantage de contrôle à l'utilisateur, à l'administrateur et à l'entreprise.

• Veuillez toutefois noter que la Graph API est réservée aux utilisateurs de MS365, et que les utilisateurs non-MS365 ne peuvent pas utiliser la Graph API.

De la part de Microsoft : https://docs.microsoft.com/en-us/graph/overview

Qui doit migrer vers la Graph API ?

Exchange Online (MS365)

Pour chaque client utilisant les solutions cloud d'Exchange Online en combinaison avec un abonnement Microsoft 365, il est fortement recommandé de passer à la Graph API avant novembre 2022. Le Bouton d'alerte phishing ne sera plus en mesure d'afficher les informations des e-mails avec l'API REST. En alternative, selon votre configuration, les clients peuvent toujours recourir à l'API EWS si nécessaire. Toutefois, cela n'est pas recommandé, car cela limitera les fonctionnalités du Bouton d'alerte phishing. Veuillez consulter notre matrice de compatibilité mise à jour pour les clients Outlook et les API serveur afin de vous assurer de choisir l'API adaptée à votre configuration.

Exchange On-Premise déploiements hybrides

Les clients utilisant une configuration hybride (Microsoft 365 + Exchange On-Premise) peuvent utiliser l'API REST jusqu'en juin 2023. Après cette date, toutes les requêtes API REST seront bloquées par Microsoft, et nous vous invitons à contacter Microsoft pour les étapes suivantes de la migration.

Retrouvez notre matrice de compatibilité mise à jour pour les clients Outlook et les API serveur ici : Compatibilité des clients Outlook et des API serveur pour le Bouton d'alerte phishing

De la part de Microsoft : Using the Outlook REST API (version 2.0) : https://docs.microsoft.com/en-us/graph/hybrid-rest-support

Recommandé : Nous recommandons vivement aux clients de contacter le support Microsoft afin de procéder correctement à la migration selon leur configuration.

Comment migrer le Bouton d'alerte phishing vers la Graph API ?

Étapes de migration :

1. Téléchargez le nouveau fichier manifeste Graph depuis les paramètres du Bouton d'alerte phishing dans le Manager.

   • Bouton d'alerte phishing / Intégrations Microsoft / Manifeste du Bouton d'alerte phishing

   • Sélectionnez l'environnement que vous utilisez.

   • Cliquez sur Download manifest file pour télécharger le fichier.

2. Mettez à jour le Bouton d'alerte phishing avec le fichier manifeste Graph.

3. Lors de l'installation, des autorisations devront être accordées pour les portées demandées par l'application Bouton d'alerte phishing. Nous vous recommandons d'accorder les autorisations pour tous les utilisateurs à l'avance ; sinon, chaque utilisateur devra accorder ses autorisations séparément après la mise à jour en saisissant ses identifiants.

4. Après l'installation du manifeste Graph, nous recommandons d'attendre 24 heures que la mise à jour soit déployée pour chaque utilisateur de l'instance.

5. Enfin, activez la Graph API dans le Manager sous les paramètres du Bouton d'alerte phishing.

   • Bouton d'alerte phishing > Intégrations e-mail > Microsoft API

Est-ce que cela changera quelque chose pour les utilisateurs finaux ?

Rien ne changera pour les utilisateurs finaux.

Une fois la transition vers la Graph API effectuée, les utilisateurs ne devraient pas constater de différence dans l'utilisation du Bouton d'alerte phishing, car le parcours utilisateur et les fonctionnalités resteront identiques.

La Simulation de phishing devra-t-elle être mise en pause ?

Tout au long du processus de migration, la Simulation de phishing n'a pas besoin d'être mise en pause, car le passage à la Graph API ne prend que quelques minutes.

EWS et RestAPI seront-ils encore pris en charge ?

Veuillez noter que Microsoft limite et/ou abandonne les fonctionnalités de RestAPI et d'EWS. En raison de ces limitations, le Bouton d'alerte phishing peut ne plus fonctionner correctement dans les configurations Cloud et hybrides. Par conséquent, le Bouton d'alerte phishing ne prend plus entièrement en charge EWS et RestAPI.