Migrer de l'API REST vers l'API Graph
ContentBody{} FormattedBody{value='
Informations générales sur la migration
Comme annoncé en novembre 2021, l'API REST sera totalement mis hors service par Microsoft en novembre 2022 dans le monde, pour tous les clients utilisant Microsoft Exchange Online.
Cela signifie que nous allons passer à l'API Graph et nous demandons gentiment à tous les clients utilisant Microsoft Exchange Online (Cloud, MS 365) de passer de l'API REST à l'API Graph si possible, afin de continuer à fournir les mêmes fonctionnalités du bouton d'alerte phishing.
De Microsoft | [OBSOLÈTE] Utiliser l'API REST Outlook
Qu'est-ce que l'API Graph ?
L'API Graph est une API développée par Microsoft qui constitue la nouvelle façon de communiquer 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 que vous pouvez faire comme 'application est basé sur l'interaction de l'utilisateur avec l'application. Cela donne plus de contrôle à l'utilisateur, à l'administrateur et à l'entreprise.
Toutefois, veuillez noter que l'API Graph est réservée aux utilisateurs de MS 365, et que les utilisateurs non-MS 365 ne peuvent pas utiliser l'API Graph.
De Microsoft | Présentation de Microsoft Graph
Qui doit migrer vers l'API Graph ?
Exchange Online (MS 365)
Pour chaque client utilisant les solutions cloud d'Exchange Online en combinaison avec un abonnement Microsoft 365, il est fortement recommandé de passer à l'API Graph d'ici novembre 2022. Le bouton d'alerte phishing ne sera plus en mesure d'afficher des informations dans les e-mails avec l'API REST. Alternativement, selon votre configuration, les clients peuvent toujours se rabattre sur l'API EWS si nécessaire. Cependant, cela n'est pas recommandé car cela restreindra l'ensemble de fonctionnalités du bouton d'alerte phishing. Veuillez consulter notre matrice de compatibilité API client et serveur Outlook mise à jour ici, pour vous assurer de choisir l'API appropriée en fonction de votre configuration.
Déploiements hybrides Exchange sur site
Les clients utilisant une configuration hybride (Microsoft 365 + Exchange sur site) peuvent utiliser l'API REST jusqu'en juin 2023. Après cette date, toutes les demandes d'API REST seront bloquées par Microsoft, et nous vous demandons de contacter Microsoft pour une autre procédure de migration.
Veuillez trouver notre mise à jour de la compatibilité de l'API client et serveur Outlook ici .
De Microsoft | Utilisation de l'API REST d'Outlook (version 2.0) : Utiliser des API REST pour accéder aux boîtes aux lettres dans les déploiements hybrides Exchange (déconseillé) – Microsoft Graph
Recommandé : Nous recommandons vivement aux clients de contacter l'assistance Microsoft pour procéder correctement à la migration en fonction de leur configuration.
Comment migrer le bouton d'alerte phishing vers l'API Graph ?
Clause de non-responsabilité : Avant de passer à l'API Graph, veuillez vérifier la compatibilité de votre système. Pour toute autre question, veuillez contacter l'assistance Microsoft.
Étapes de la migration :
Téléchargez le nouveau fichier manifeste Graph depuis les paramètres du bouton d'alerte phishing dans Manager.
Bouton d'alerte phishing > Intégration des e-mails > Bouton d'alerte phishing manifeste
Choisissez l’option dans le menu Manifest correspondante à votre environnement Azure.
Téléchargez le fichier manifeste
Mettez à jour le bouton d'alerte phishing avec le fichier manifeste Graph.
Lors de l'installation, des autorisations devront être accordées aux requêtes demandées de l'application du bouton d'alerte phishing. Nous vous recommandons d'accorder des autorisations à tous les utilisateurs à l'avance, sinon chaque utilisateur devra accorder son autorisation séparément après la mise à jour, en saisissant ses identifiants.
Veuillez noter : Cette installation ne fonctionne pas pour les appareils mobiles en raison de limitations techniques de Microsoft. Les utilisateurs d'appareils mobiles qui rencontrent des problèmes d'authentification verront s'afficher une fenêtre contextuelle avec la page de connexion Microsoft, où ils devront saisir leurs identifiants pour s'authentifier. Cela ne devrait se produire qu'une seule fois.
Après l'installation du manifeste Graph, nous vous recommandons d'attendre 24 heures jusqu'à ce que la mise à jour soit déployée chez chaque utilisateur client.
Enfin, activez l'API Graph dans Manager sous les paramètres du bouton d'alerte phishing.
Bouton d'alerte phishing > Intégration des e-mails > Microsoft API
Cela changera-t-il quelque chose pour les utilisateurs finals ?
Rien ne changera pour les utilisateurs finals.
Une fois la transition vers l'API Graph effectuée, les utilisateurs ne devraient pas remarquer de différence dans l'utilisation du bouton d'alerte phishing, car le flux d'utilisateurs et les fonctionnalités resteront les mêmes.
L'API EWS et l'API REST seront-elles toujours prises en charge ?
Oui, le bouton d'alerte phishing continuera à prendre en charge l'API EWS et l'API REST.