Tipo de recurso phoneAuthenticationMethod
Espacio de nombres: microsoft.graph
Importante
Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.
Representación de un teléfono registrado para un usuario. Este recurso incluye el número de teléfono, el tipo de teléfono y si el teléfono 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 | Lee las propiedades y las relaciones del objeto phoneAuthenticationMethod. |
| Add | phoneAuthenticationMethod | Create el objeto phoneAuthenticationMethod de un usuario. |
| Actualizar | phoneAuthenticationMethod | Actualice el objeto phoneAuthenticationMethod. |
| Delete | Ninguno | Elimine el objeto phoneAuthenticationMethod. |
| 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 "+<número de código>><de país x<extensión>", 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 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 móvil principal de un usuario, 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"
}