Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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.
Expone los estados del método de autenticación para los usuarios y las relaciones que representan los métodos de autenticación admitidos por Microsoft Entra ID. Se admiten los siguientes estados de métodos de autenticación:
- Preferencias de inicio de sesión de un usuario (MFA preferida por el sistema)
- Estado de MFA de un usuario (MFA por usuario)
Hereda de la entidad.
Methods
| Método | Tipo devuelto | Descripción |
|---|---|---|
| Get | authentication | Obtenga los estados de autenticación de un usuario, como sus preferencias de inicio de sesión y su estado de MFA. |
| Actualizar | authentication | Actualice los estados de autenticación de un usuario, como sus preferencias de inicio de sesión y su estado de MFA. |
Propiedades
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Identificador único. Solo lectura. |
| requirements | strongAuthenticationRequirements | La configuración y las preferencias de la autenticación multifactor por usuario Microsoft Entra. |
| signInPreferences | signInPreferences | Configuración y preferencias para la experiencia de inicio de sesión de un usuario. Use esta propiedad para configurar el método de autenticación multifactor (MFA) predeterminado del usuario. |
Relaciones
| Relación | Tipo | Descripción |
|---|---|---|
| emailMethods | colección emailAuthenticationMethod | Representa las direcciones de correo electrónico registradas en un usuario para la autenticación. |
| externalAuthenticationMethods | colección externalAuthenticationMethod | Representa los métodos externos registrados en un usuario para la autenticación. |
| fido2Methods | fido2AuthenticationMethod (colección) | Representa las claves de seguridad FIDO2 registradas en un usuario para la autenticación. |
| hardwareOathMethods | colección hardwareOathAuthenticationMethod | Los dispositivos de contraseña única (TOTP) basados en tiempo de oath de hardware asignados a un usuario para la autenticación. |
| métodos | colección authenticationMethod | Representa todos los métodos de autenticación registrados en un usuario. |
| microsoftAuthenticatorMethods | Colección microsoftAuthenticatorAuthenticationMethod | Los detalles de la aplicación Microsoft Authenticator registradas en un usuario para la autenticación. |
| operations | colección longRunningOperation | Representa el estado de una operación de ejecución prolongada, como una operación de restablecimiento de contraseña. |
| passwordlessMicrosoftAuthenticatorMethods | colección passwordlessMicrosoftAuthenticatorAuthenticationMethod | Representa los métodos de inicio de sesión de teléfono sin contraseña de Microsoft Authenticator registrados en un usuario para la autenticación. |
| passwordMethods | colección passwordAuthenticationMethod | Representa los detalles del método de autenticación de contraseña registrado en un usuario para la autenticación. |
| phoneMethods | colección phoneAuthenticationMethod | Representa el teléfono registrado en un usuario para la autenticación. |
| qrCodePinMethod | qrCodePinAuthenticationMethod | Representa un método de autenticación de código QR registrado en un usuario para la autenticación. |
| platformCredentialMethods | platformCredentialAuthenticationMethod (colección) | Representa una instancia de credencial de plataforma registrada para un usuario en Mac OS. |
| softwareOathMethods | Colección softwareOathAuthenticationMethod | Las aplicaciones de contraseña única (TOTP) basadas en tiempo de OATH de software registradas en un usuario para la autenticación. |
| temporaryAccessPassMethods | Colección temporaryAccessPassAuthenticationMethod | Representa un pase de acceso temporal registrado a un usuario para la autenticación a través de códigos de acceso limitados por tiempo. |
| windowsHelloForBusinessMethods | Colección windowsHelloForBusinessAuthenticationMethod | Representa el método de autenticación Windows Hello para empresas registrado en un usuario para la autenticación. |
Representación JSON
La siguiente representación JSON muestra el tipo de recurso.
{
"@odata.type": "#microsoft.graph.authentication",
"id": "String (identifier)",
"signInPreferences": {
"@odata.type": "microsoft.graph.signInPreferences"
},
"requirements": {
"@odata.type": "microsoft.graph.strongAuthenticationRequirements"
}
}