Type de ressource phoneAuthenticationMethod

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.

Représentation d’un téléphone enregistré pour 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 a l’un des trois types : mobile, mobile de remplacement ou bureau. Un utilisateur peut avoir un numéro inscrit 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 du mot de passe libre-service (SSPR), le téléphone mobile est le téléphone mobile par défaut et l’autre téléphone mobile est la sauvegarde.

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

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

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 relations de l’objet phoneAuthenticationMethod.
Mettre à jour phoneAuthenticationMethod Mettre à jour l’objet phoneAuthenticationMethod.
Supprimer Aucun Supprimez l’objet phoneAuthenticationMethod.
Désactiver la signature SMS Aucun Désactiver la connectez-vous PAR SMS pour un utilisateur.
Activer la signature SMS Aucun Activer la signature SMS pour un utilisateur.

Propriétés

Propriété Type Description
id String Identificateur de ce téléphone enregistré pour 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 Numéro de téléphone à envoyer au texte ou appeler pour l’authentification. Téléphone numériques utilisent le format « + <country code> <number> » 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 les suivantes : mobile, alternateMobile ou office.
smsSignInState authenticationMethodSignInState Si un téléphone est prêt à être utilisé pour la signature SMS ou non. Les valeurs possibles notSupported sont : , , , , ou , notAllowedByPolicy notEnabled phoneNumberNotUnique ready notConfigured unknownFutureValue .

Valeurs smsSignInState

La propriété d’état de la signature SMS fournit des informations sur la préparation ou non d’un numéro de téléphone à se connecter par SMS. Voici les valeurs possibles.

Valeur Description
notSupported La authentification principale n’est pas prise en charge par cette méthode d’authentification . Par exemple, la sign-in peut être activée uniquement sur le numéro mobile principal d’un utilisateur, et non sur l’autre numéro.
notAllowedByPolicy Cet utilisateur n’est pas activé par la stratégie pour utiliser cette méthode en tant que principale sign-in.
notConfigured Cet utilisateur est activé par la stratégie pour utiliser cette méthode en tant que principale sign-in, mais doit prendre des mesures supplémentaires pour la configurer.
phoneNumberNotUnique Cet utilisateur a tenté de configurer un numéro de téléphone comme principal, mais le numéro n’était pas unique et ne peut pas être utilisé comme nom de sign-in.
ready Cette méthode d’authentification est prête à être utilisée dans la signature principale.
notEnabled Cette méthode de sign-in n’est pas activée

Relations

Aucun.

Représentation JSON

Voici une représentation JSON de la ressource.

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