type de ressource phoneAuthenticationMethod

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. 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 v1.0, utilisez le sélecteur Version .

Représentation d’un téléphone enregistré au nom d’un utilisateur. Cette ressource inclut le numéro de téléphone, le type de téléphone et indique si le téléphone est configuré pour que l’utilisateur puisse se connecter par SMS.

Un téléphone est de l’un des trois types suivants : mobile, mobile alternatif ou bureau. Un utilisateur peut avoir un numéro enregistré pour chaque type et doit avoir un téléphone mobile avant qu’un autre téléphone mobile ne soit ajouté. Lorsque vous utilisez un téléphone pour l’authentification multifacteur (MFA) ou la réinitialisation de mot de passe en libre-service (SSPR), le téléphone mobile est le numéro par défaut et le téléphone mobile de remplacement est la solution de secours.

Les téléphones mobiles principaux peuvent être utilisés pour les appels SMS et vocaux, selon les paramètres du locataire.

Un téléphone de bureau ne peut recevoir que des appels vocaux, et non des SMS.

Il s’agit d’un type dérivé qui hérite du type de ressource authenticationMethod .

Méthodes

Méthode	Type renvoyé	Description
List	phoneAuthenticationMethod	Lisez les propriétés et les relations de tous les objets phoneAuthenticationMethod de cet utilisateur.
Obtenir	phoneAuthenticationMethod	Lisez les propriétés et les relations de l’objet phoneAuthenticationMethod.
Add	phoneAuthenticationMethod	Créez l’objet phoneAuthenticationMethod d’un utilisateur.
Mettre à jour	phoneAuthenticationMethod	Mettez à jour l’objet phoneAuthenticationMethod.
Supprimer	Aucun	Supprimez l’objet phoneAuthenticationMethod.
Désactiver la connexion par SMS	Aucun	Désactivez la connexion par SMS pour un utilisateur.
Activer la connexion par SMS	Aucun	Activer la connexion par SMS pour un utilisateur.

Propriétés

Propriété	Type	Description
createdDateTime	DateTimeOffset	Date et heure auxquelles la méthode d’authentification a été enregistrée au nom de l’utilisateur. En lecture seule. Facultatif. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z.
lastUsedDateTime	DateTimeOffset	Date et heure de la dernière utilisation de la méthode d’authentification par l’utilisateur. En lecture seule. Facultatif. Cette valeur facultative est null si la méthode d’authentification ne la renseigne pas. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, le 1er janvier 2014 à minuit UTC se présente comme suit : 2014-01-01T00:00:00Z. Hérité d’authenticationMethod.
id	String	Identifiant de ce téléphone enregistré au nom de cet utilisateur. En lecture seule. La valeur de l’ID est l’une des suivantes : b6332ec1-7057-4abe-9331-3d72feddfe41 - où phoneType est alternateMobile. e37fc753-ff3b-4958-9484-eaa9425c82bc - où phoneType est office. 3179e48a-750b-4051-897c-87b9720928f7 - où phoneType est mobile.
phoneNumber	String	Le numéro de téléphone pour envoyer un SMS ou appeler pour l’authentification. Les numéros de téléphone utilisent le format « +<numéro>de code><du pays x<extension> », avec extension facultative. Par exemple, +1 5555551234 ou +1 5555551234x123 sont valides. Les nombres sont rejetés lors de la création/mise à jour s’ils ne correspondent pas au format requis.
phoneType	authenticationPhoneType	Type de ce téléphone. Les valeurs possibles sont : mobile, alternateMobile, ou office.
smsSignInState	authenticationMethodSignInState	Si un téléphone est prêt à être utilisé pour la connexion par SMS ou non. Les valeurs possibles sont : notSupported, , notEnablednotAllowedByPolicy, phoneNumberNotUniqueready, ou notConfigured, unknownFutureValue.

valeurs authenticationPhoneType

Les téléphones peuvent être de trois types, voici les valeurs possibles.

Valeur	Description
mobile	Un téléphone mobile principal, utilisable pour les SMS et les appels vocaux.
alternateMobile	Un téléphone mobile de remplacement ou de secours, utilisable uniquement pour les appels vocaux.
Bureau	Un téléphone de bureau ou fixe, utilisable uniquement pour les appels vocaux.

valeurs authenticationMethodSignInState

La propriété d’état de connexion par SMS indique si un numéro de téléphone est prêt ou non à se connecter par SMS. Voici les valeurs possibles.

Valeur	Description
notSupported	Connexion principale non prise en charge avec cette méthode d’authentification : par exemple, la connexion peut être activée uniquement sur le numéro de téléphone mobile principal d’un utilisateur, et non sur le numéro secondaire.
notAllowedByPolicy	Cet utilisateur n’est pas activé par la stratégie pour utiliser cette méthode comme connexion principale.
notConfigured	Cet utilisateur est activé par la stratégie pour utiliser cette méthode comme connexion principale, mais il doit prendre d’autres mesures pour la configurer.
phoneNumberNotUnique	Cet utilisateur a tenté de configurer un numéro de téléphone comme connexion principale, mais le numéro n’était pas unique et ne peut pas être utilisé comme nom de connexion.
prêt	Cette méthode d’authentification est prête à être utilisée dans la connexion principale.
notEnabled	Cette méthode de connexion n’est pas activée

Relations

Aucun.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

{
  "@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
  "createdDateTime": "String (timestamp)",
  "lastUsedDateTime": "String (timestamp)",
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}