Créer emailAuthenticationMethod

Cette page est-elle utile ?

D'autres commentaires ?

Les commentaires seront envoyés à Microsoft : en appuyant sur le bouton envoyer, vos commentaires seront utilisés pour améliorer les produits et services Microsoft. Politique de confidentialité.

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

HTTP

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

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

JavaScript

const options = {
    authProvider,
};

const client = Client.init(options);

const emailAuthenticationMethod = {
  emailAddress: 'kim@contoso.com'
};

await client.api('/users/kim@contoso.com/authentication/emailMethods')
    .version('beta')
    .post(emailAuthenticationMethod);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Objective-C

MSHTTPClient *httpClient = [MSClientFactory createHTTPClientWithAuthenticationProvider:authenticationProvider];

NSString *MSGraphBaseURL = @"https://graph.microsoft.com/beta/";
NSMutableURLRequest *urlRequest = [NSMutableURLRequest requestWithURL:[NSURL URLWithString:[MSGraphBaseURL stringByAppendingString:@"/users/kim@contoso.com/authentication/emailMethods"]]];
[urlRequest setHTTPMethod:@"POST"];
[urlRequest setValue:@"application/json" forHTTPHeaderField:@"Content-Type"];

MSGraphEmailAuthenticationMethod *emailAuthenticationMethod = [[MSGraphEmailAuthenticationMethod alloc] init];
[emailAuthenticationMethod setEmailAddress:@"kim@contoso.com"];

NSError *error;
NSData *emailAuthenticationMethodData = [emailAuthenticationMethod getSerializedDataWithError:&error];
[urlRequest setHTTPBody:emailAuthenticationMethodData];

MSURLSessionDataTask *meDataTask = [httpClient dataTaskWithRequest:urlRequest 
    completionHandler: ^(NSData *data, NSURLResponse *response, NSError *nserror) {

        //Request Completed

}];

[meDataTask execute];

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

C#

GraphServiceClient graphClient = new GraphServiceClient( authProvider );

var emailAuthenticationMethod = new EmailAuthenticationMethod
{
    EmailAddress = "kim@contoso.com"
};

await graphClient.Users["{user-id}"].Authentication.EmailMethods
    .Request()
    .AddAsync(emailAuthenticationMethod);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Java

GraphServiceClient graphClient = GraphServiceClient.builder().authenticationProvider( authProvider ).buildClient();

EmailAuthenticationMethod emailAuthenticationMethod = new EmailAuthenticationMethod();
emailAuthenticationMethod.emailAddress = "kim@contoso.com";

graphClient.users("kim@contoso.com").authentication().emailMethods()
    .buildRequest()
    .post(emailAuthenticationMethod);

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

Activer

//THE GO SDK IS IN PREVIEW. NON-PRODUCTION USE ONLY
graphClient := msgraphsdk.NewGraphServiceClient(requestAdapter)

requestBody := msgraphsdk.NewEmailAuthenticationMethod()
emailAddress := "kim@contoso.com"
requestBody.SetEmailAddress(&emailAddress)
userId := "user-id"
result, err := graphClient.UsersById(&userId).Authentication().EmailMethods().Post(requestBody)

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

PowerShell

Import-Module Microsoft.Graph.Identity.SignIns

$params = @{
    EmailAddress = "kim@contoso.com"
}

New-MgUserAuthenticationEmailMethod -UserId $userId -BodyParameter $params

Important

Les SDK Microsoft Graph utilisent la version v1.0 de l’API par défaut et ne sont pas en charge tous les types, propriétés et API disponibles dans la version bêta. Pour plus d’informations sur l’accès à l’API bêta avec le SDK, voir Utiliser les SDK Microsoft Graph avec l’API bêta.

Lisez la documentation du SDK pour plus d’informations sur l’ajout du SDK à votre projet et la création d’une instance authProvider.

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"
}