Compartir a través de


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:
  • b6332ec1-7057-4abe-9331-3d72feddfe41 - donde phoneType es alternateMobile.
  • e37fc753-ff3b-4958-9484-eaa9425c82bc - donde phoneType es office.
  • 3179e48a-750b-4051-897c-87b9720928f7 - donde phoneType es mobile.
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"
}