Créer emailAuthenticationMethod

Espace de noms: microsoft.graph

Important

Les API sous /beta la version dans Microsoft Graph sont sujettes à modification. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans la version 1.0, utilisez le sélecteur de version.

Définissez l’objet emailAuthenticationMethod d’un utilisateur. L’authentification de messagerie électronique est une méthode de réinitialisation de mot de passe en libre-service. Un utilisateur ne peut avoir qu’une seule méthode d’authentification de messagerie.

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

Autorisations agissant de façon autonome

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) UserAuthenticationMethod.ReadWrite
Déléguée (compte Microsoft personnel) Non prise en charge.
Application Non prise en charge.

Autorisations agissant sur d’autres utilisateurs

Type d’autorisation Autorisations (de celle qui offre le plus de privilèges à celle qui en offre le moins)
Déléguée (compte professionnel ou scolaire) UserAuthenticationMethod.ReadWrite.All
Déléguée (compte Microsoft personnel) Non prise en charge.
Application UserAuthenticationMethod.ReadWrite.All

Pour les scénarios délégués où un administrateur agit sur un autre utilisateur, l’administrateur a besoin de l’un des rôles suivants:

  • Administrateur global
  • Administrateur d'authentification privilégié
  • Administrateur de l'authentification

Requête HTTP

POST /users/{id | userPrincipalName}/authentication/emailMethods

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire.
Content-Type application/json. Obligatoire.

Corps de la demande

Dans le corps de la demande, fournissez une représentation JSON de l’objet emailAuthenticationMethod avec l’adresse de messagerie souhaitée.

Le tableau suivant indique les propriétés qui sont requises lorsque vous créez l’emailAuthenticationMethod.

Propriété Type Description
emailAddress String Adresse électronique

Réponse

Si elle réussit, cette méthode renvoie un code de réponse et un nouvel objet 201 Created emailAuthenticationMethod dans le corps de la réponse.

Exemples

Demande

POST https://graph.microsoft.com/beta/users/kim@contoso.com/authentication/emailMethods
Content-Type: application/json

{
  "emailAddress": "kim@contoso.com"
}

Réponse

Voici un exemple de réponse.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "3ddfcfc8-9383-446f-83cc-3ab9be4be18f",
  "emailAddress": "kim@contoso.com"
}