Type de ressource phoneAuthenticationMethod

  • Article

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 inscrit auprès d’un utilisateur. Cette ressource inclut le numéro de téléphone, le type de téléphone et si le téléphone 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
Répertorier phoneMethods phoneAuthenticationMethod Lit les propriétés et relations de tous les objets phoneAuthenticationMethod de cet utilisateur.
Obtenir phoneAuthenticationMethod phoneAuthenticationMethod Lit les propriétés et les relations de l’objet phoneAuthenticationMethod.
Créer phoneMethod phoneAuthenticationMethod Créez l’objet phoneAuthenticationMethod d’un utilisateur.
Mettre à jour phoneAuthenticationMethod phoneAuthenticationMethod Mettez à jour l’objet phoneAuthenticationMethod.
Supprimer phoneAuthenticationMethod Aucune Supprimez l’objet phoneAuthenticationMethod.
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 « +< numéro de>code><de pays x<extension> », avec l’extension facultative. Par exemple, +1 5555551234 ou +1 5555551234 x 123 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 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 à se connecter 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, et non 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.

{
  "id": "String (identifier)",
  "phoneNumber": "String",
  "phoneType": "string",
  "smsSignInState": "string"
}