Tipo de recurso phoneAuthenticationMethod
Espacio de nombres: microsoft.graph
Representa un número de teléfono y un tipo que está registrado para un usuario y si está configurado para que el usuario inicie sesión a través de SMS.
Un teléfono tiene uno de los tres tipos: móvil, móvil alternativo u oficina. Un usuario puede tener un número registrado para cada tipo y debe tener un teléfono móvil antes de agregar un teléfono móvil alternativo. Cuando se usa un teléfono para la autenticación multifactor (MFA) o el autoservicio de restablecimiento de contraseña (SSPR), el teléfono móvil es el valor predeterminado y el teléfono móvil alternativo es la copia de seguridad.
Los teléfonos móviles principales se pueden usar para llamadas SMS y de voz, en función de la configuración del inquilino.
Un teléfono de la oficina solo puede recibir llamadas de voz, no mensajes SMS.
Se trata de un tipo derivado que hereda del tipo de recurso authenticationMethod .
Métodos
| Método | Tipo de valor devuelto | Descripción |
|---|---|---|
| List | phoneAuthenticationMethod | Lea las propiedades y las relaciones de todos los objetos phoneAuthenticationMethod de este usuario. |
| Get | phoneAuthenticationMethod | Lea las propiedades y las relaciones del objeto phoneAuthenticationMethod para un usuario. |
| Add | phoneAuthenticationMethod | Create el objeto phoneAuthenticationMethod de un usuario. |
| Actualizar | Ninguno | Actualice el objeto phoneAuthenticationMethod para un usuario. |
| Delete | Ninguno | Elimine el objeto phoneAuthenticationMethod para un usuario. |
| Deshabilitar el inicio de sesión de SMS | Ninguno | Desactivar el inicio de sesión de SMS para un usuario. |
| Habilitación del inicio de sesión de SMS | Ninguno | Active el inicio de sesión de SMS para un usuario. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador de este teléfono registrado para este usuario. Solo lectura. El valor de ID es uno de los siguientes:
|
| phoneNumber | Cadena | Número de teléfono al que se va a enviar un mensaje de texto o a la llamada para la autenticación. Los números de teléfono usan el formato +{country code} {number}x{extension}, con la extensión opcional. Por ejemplo, +1 5555551234 o +1 5555551234x123 son válidos. Los números se rechazan al crear o actualizar si no coinciden con el formato necesario. |
| phoneType | authenticationPhoneType | Tipo de este teléfono. Los valores posibles son mobile, alternateMobile o office. |
| smsSignInState | authenticationMethodSignInState | Si un teléfono está listo para usarse para el inicio de sesión por SMS o no. Los valores posibles son: notSupported, notAllowedByPolicy, notEnabled, phoneNumberNotUnique, readyo notConfigured, unknownFutureValue. |
valores authenticationPhoneType
Los teléfonos pueden ser de tres tipos, los siguientes son los valores posibles.
| Valor | Description |
|---|---|
| móvil | Un teléfono móvil principal, que se puede usar para sms y llamadas de voz. |
| alternateMobile | Un teléfono móvil alternativo o de copia de seguridad, que solo se puede usar para llamadas de voz. |
| oficina | Teléfono de oficina o teléfono fijo, utilizable solo para llamadas de voz. |
valores authenticationMethodSignInState
La propiedad de estado de inicio de sesión de SMS proporciona información sobre si un número de teléfono está listo o no para iniciar sesión a través de SMS. A continuación se muestran los valores posibles.
| Valor | Description |
|---|---|
| notSupported | El inicio de sesión principal no se admite en este método de autenticación. Por ejemplo, el inicio de sesión solo se puede habilitar en el número de móvil principal de un usuario, pero no en el número alternativo. |
| notAllowedByPolicy | La directiva no habilita a este usuario para usar este método como inicio de sesión principal. |
| notConfigured | La directiva habilita a este usuario para usar este método como inicio de sesión principal, pero debe realizar más acciones para configurarlo. |
| phoneNumberNotUnique | Este usuario intentó configurar un número de teléfono como inicio de sesión principal, pero el número no era único y no se puede usar como nombre de inicio de sesión. |
| Listo | Este método de autenticación está listo para su uso en el inicio de sesión principal. |
| notEnabled | Este método de inicio de sesión no está habilitado |
Relaciones
Ninguna.
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.phoneAuthenticationMethod",
"id": "String (identifier)",
"phoneNumber": "String",
"phoneType": "string",
"smsSignInState": "string"
}