Partager via


Type de ressource phoneAuthenticationMethod

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