Table of contents
TOC
Réduire la table des matières
Développer la table des matières
Dernière mise à jour: 25/07/2018

Authentifiez les API Office 365 et Outlook.com en utilisant la préversion du point de terminaison d'authentification v2.0

S'applique à : Office 365 | Outlook.com

Documentation de la préversion
Ce sont des particularités et des fonctionnalités du point de terminaison d'authentification v2.0 qui ne sont pas encore prises en charge pendant la période de préversion publique. Vous devez en être conscient si vous créez des applications pendant la préversion publique. Pour plus d'informations, voir Limitations et restrictions de la préversion du modèle d'application V2.0.

Connexion d’utilisateurs de comptes Microsoft et Azure AD avec un modèle d’authentification simple

La préversion du point de terminaison d’authentification de la version 2.0 vous permet de créer des applications qui acceptent aussi bien des identités professionnelles et scolaires (Azure AD), que des identités personnelles (compte Microsoft).

Dans le passé, un développeur d'applications souhaitant prendre en charge à la fois les comptes Microsoft et Azure Active Directory devait intégrer deux systèmes complètement distincts. Maintenant, vous pouvez créer des applications utilisant le point de terminaison d'authentification v2.0, qui vous permet d'authentifier des utilisateurs avec les deux types de comptes. Un seul processus simple vous permet d'atteindre immédiatement un public comptant des millions d'utilisateurs ayant à la fois des comptes personnels et professionnels.

Actuellement, vos applications peuvent accéder aux API suivantes, en utilisant la préversion du point de terminaison d'authentification v2.0 :

  • Messagerie Outlook
  • Contacts Outlook
  • Calendriers Outlook

plus de services Microsoft étant ajoutés dans un proche avenir.

Exemples de code

Explorez l'exemple de code suivant pour apprendre à créer des applications qui utilisent la préversion du point de terminaison d'authentification v2.0 pour accéder aux API Office.

Étendues d'authentification de l'API Office

La table ci-dessous liste les étendues d'authentification à utiliser avec la préversion du point de terminaison d'authentification v2. Pour en savoir plus sur les étendues de l'utilisation du point de terminaison version 2.0 et en quoi elle diffère de l’utilisation de ressources dans Azure AD, voir Etendues, et non ressources.

Étendues de courrier, de calendrier et de contacts d'Outlook

ÉtendueAutorisationDescription
https://outlook.office.com/mail.readAccéder en lecture aux courriers électroniques utilisateurPermet à cette application de lire les messages dans les boîtes aux lettres des utilisateurs.
https://outlook.office.com/mail.readwriteAccéder en lecture et en écriture aux courriers électroniques utilisateurPermet à l'application de lire, de mettre à jour, de créer et de supprimer des messages dans les boîtes aux lettres des utilisateurs.
https://outlook.office.com/mail.sendEnvoyer un courrier électronique en tant qu’utilisateurPermet à l’application d’envoyer des messages en tant qu'utilisateurs dans l’organisation.
https://outlook.office.com/contacts.readAccéder en lecture aux contacts utilisateurPermet à l’application de lire les contacts de l’utilisateur.
https://outlook.office.com/contacts.readwriteAvoir un accès total à des contacts utilisateurPermet à l’application de lire, de mettre à jour et de supprimer des contacts des utilisateurs.
https://outlook.office.com/calendars.readAccéder en lecture aux calendriers utilisateurPermet à l’application de lire les événements dans les calendriers utilisateur.
https://outlook.office.com/calendars.readwriteAvoir un accès total à des calendriers utilisateurPermet à l’application de lire, de mettre à jour et de supprimer des événements dans les calendriers des utilisateurs.

Les API Outlook

  • Ces API fonctionnent pour tous les utilisateurs d'Office 365. Nous activons progressivement ces API pour les utilisateurs d'outlook.com. Lorsqu'une application fait une requête ciblant une boîte aux lettres d'outlook.com qui n'a pas encore été activée pour les API REST, nous retournons une erreur spéciale "UserNotSupported" avec le statut Http 404. Votre application doit gérer ce cas avec élégance.

  • Pour des performances optimales, nous recommandons d'ajouter un en-tête x-AnchorMailbox à chaque requête, et de le définir comme étant l'adresse de courrier de la boîte aux lettres cible.

  • Actuellement, vous devez envoyer directement les requêtes de l'API REST au point de terminaison. Les SDK Office 365 continuent à utiliser le point de terminaison d'Azure AD.

  • Reportez-vous à l'exemple de code suivant pour l'utilisation de la préversion du modèle d'application v2.0 avec les API d'Outlook :

Étapes suivantes

Inscrivez une application pour utiliser le point de terminaison version 2.0

En savoir plus

Limitations et restrictions de la préversion du point de terminaison v2.0

Quoi de neuf dans la préversion du point de terminaison v2.0

Davantage de Documentation de la préversion du point de terminaison d'authentification v2.0 sur azure.microsoft.com

© 2018 Microsoft