Type de ressource phoneAuthenticationMethod

Article
05/24/2024

Espace de noms: microsoft.graph

Représente un numéro de téléphone et un type inscrits auprès d’un utilisateur, et indique s’il est configuré pour que l’utilisateur se connecte par SMS.

Un téléphone est de trois types : mobile, mobile alternatif ou bureau. Un utilisateur peut avoir un numéro inscrit pour chaque type et doit disposer d’un téléphone mobile avant l’ajout d’un autre téléphone mobile. 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 la valeur par défaut et l’autre téléphone mobile est la sauvegarde.

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

Un téléphone de bureau ne peut recevoir que des appels vocaux, pas 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	Lit les propriétés et relations de tous les objets phoneAuthenticationMethod de cet utilisateur.
Obtenir	phoneAuthenticationMethod	Lit les propriétés et les relations de l’objet phoneAuthenticationMethod pour un utilisateur.
Add	phoneAuthenticationMethod	Create l’objet phoneAuthenticationMethod d’un utilisateur.
Mettre à jour	Aucun	Mettez à jour l’objet phoneAuthenticationMethod pour un utilisateur.
Supprimer	Aucune	Supprimez l’objet phoneAuthenticationMethod d’un utilisateur.
Désactiver la connexion PAR SMS	Aucune	Désactivez la connexion PAR SMS pour un utilisateur.
Activer la connexion PAR SMS	Aucune	Activer la connexion PAR SMS pour un utilisateur.

Propriétés

Propriété	Type	Description
id	Chaîne	Identificateur de ce téléphone inscrit auprès de cet utilisateur. En lecture seule. La valeur de 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	Chaîne	Numéro de téléphone à envoyer par SMS ou appeler pour l’authentification. Les numéros de téléphone utilisent le format `+{country code} {number}x{extension}`, avec l’extension facultative. Par exemple, `+1 5555551234` ou `+1 5555551234x123` sont valides. Les nombres sont rejetés lors de la création ou de la mise à jour s’ils ne correspondent pas au format requis.
phoneType	authenticationPhoneType	Type de ce téléphone. Les valeurs possibles sont les suivantes : `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 , `notAllowedByPolicynotSupported`, `notEnabled`, `phoneNumberNotUnique`, `ready`ou `notConfigured`. `unknownFutureValue`

valeurs authenticationPhoneType

Les téléphones peuvent être de trois types : les valeurs possibles sont les suivantes.

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

valeurs authenticationMethodSignInState

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

Valeur	Description
notSupported	La connexion principale n’est pas prise en charge sur 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, mais pas sur le numéro de remplacement.
notAllowedByPolicy	Cet utilisateur n’est pas autorisé par la stratégie à utiliser cette méthode comme connexion principale.
notConfigured	Cet utilisateur est autorisé par la stratégie à utiliser cette méthode comme connexion principale, mais doit prendre des mesures supplémentaires pour la configurer.
phoneNumberNotUnique	Cet utilisateur a tenté de configurer un numéro de téléphone en tant que connexion principale, mais ce 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",
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}

Partager via