Gérer l’inscription d’application et l’autorisation d’API pour les notifications de Microsoft Graph (déconseillé)

Importante

L’API de notifications Microsoft Graph est déconseillée et a cessé de retourner des données en janvier 2022. Pour une autre expérience de notification, consultez Microsoft Azure Notification Hubs. Pour plus d’informations, consultez le billet de blog Retiring Microsoft Graph notifications API (bêta).

Pour que votre service d’application puisse s’intégrer avec les notifications de Microsoft Graph, vous devez inscrire votre application sur la plateforme d’identités Microsoft pour permettre la prise en charge de comptes Microsoft ainsi que de comptes professionnels ou scolaires, et déclarer les autorisations d’API requises.

Inscrire votre application pour prendre en charge les comptes Microsoft et les comptes professionnels ou scolaires

Inscrivez votre application sur le centre d'administration Microsoft Entra pour prendre en charge les comptes Microsoft ou les comptes professionnels ou scolaires. Si vous avez déjà inscrit votre application sur le portail d’applications Microsoft, vos applications existantes s’affichent dans la page d’inscriptions d’applications.

Pour plus d’informations sur la procédure d’inscription d’application, voir Inscrire une application sur la Plateforme d’identités Microsoft. Lorsque vous inscrivez votre application, veillez à garder l’ID d’application/ID client à portée de main. Vous en aurez besoin plus tard quand vous inscrirez votre application pour des expériences inter-appareils dans l’Espace partenaires pour les clients Windows, Android ou iOS.

Remarque

Si vous n’avez pas encore de compte Microsoft et souhaitez en utiliser un, accédez à la page Compte Microsoft . Si vous écrivez une application qui doit utiliser Azure AD v1.0 comme infrastructure d’authentification et d’identité pour les comptes professionnels ou scolaires, consultez Bibliothèque d’authentification Azure Active Directory (ADAL). Si vous souhaitez découvrir ou utiliser la nouvelle Plateforme d'identités Microsoft convergée (v2.0), consultez Qu’est-ce que la Plateforme d'identités Microsoft ?.

Certificats et secrets d’applications

Pour permettre à votre application de s’identifier et de s’authentifier lors de l’obtention de jetons d’authentification, vous pouvez charger votre propre certificat ou créer une clé secrète client en accédant à Certificats & secrets dans la page d’inscriptions d’applications centre d'administration Microsoft Entra.

Remarque

Si vous choisissez de générer une nouvelle clé secrète client, veillez à le copier et à la conserver en lieu sûr. Vous ne pourrez plus y accéder une fois que vous quitterez le portail.

Autorisations de l’API

Pour pouvoir utiliser l’API de notifications Microsoft Graph, vous devrez ajouter des autorisations. Choisissez Ajouter une autorisation. Ensuite, sous API Microsoft, sélectionnez Microsoft Graph, puis Autorisations déléguées.

Ajoutez les autorisations suivantes :

• User.Read : autorise votre application à connecter votre utilisateur

• UserActivity.ReadWrite.CreatedByApp : autorise un abonnement d’application à récupérer une notification

Étapes suivantes

Apprenez-en davantage sur les autorisations et le consentement, ou consultez Référence des autorisations de Microsoft Graph.

Maintenant que vous avez inscrit votre application, visitez l’Espace partenaires pour configurer votre application et cibler vos plateformes d’application correspondantes (Windows, iOS ou Android) pour les notifications envoyées via Microsoft Graph. Pour plus d’informations, voir Intégration à des expériences inter-appareils.

Remarque

Si vous ciblez uniquement des points de terminaison web, vous pouvez ignorer l’inscription à l’Espace partenaires et découvrir comment configurer votre service d’application pour envoyer des notifications.