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 para la autenticación multifactor de Microsoft Entra por usuario. |
| signInPreferences | signInPreferences | La configuración y las preferencias de 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 a nombre de un usuario para la autenticación. |
| externalAuthenticationMethods | Colección externalAuthenticationMethod | Representa la MFA externa registrada a nombre de un usuario para la autenticación. |
| fido2Methods | Colección fido2AuthenticationMethod | Representa las claves de seguridad FIDO2 registradas a nombre de un usuario para la autenticación. |
| hardwareOathMethods | Colección hardwareOathAuthenticationMethod | Los dispositivos de contraseña de un solo uso basados en tiempo (TOTP) de OATH de hardware asignados a un usuario para la autenticación. |
| de pago | Colección authenticationMethod | Representa todos los métodos de autenticación registrados a nombre de un usuario. |
| microsoftAuthenticatorMethods | Colección microsoftAuthenticatorAuthenticationMethod | Los detalles de la aplicación Microsoft Authenticator registrada a nombre de un usuario para la autenticación. |
| operations | Colección longRunningOperation | Representa el estado de una operación de larga duración, como una operación de restablecimiento de contraseña. |
| passwordlessMicrosoftAuthenticatorMethods | Colección passwordlessMicrosoftAuthenticatorAuthenticationMethod | Representa los métodos de inicio de sesión por teléfono sin contraseña de Microsoft Authenticator registrados a nombre de un usuario para la autenticación. |
| passwordMethods | Colección passwordAuthenticationMethod | Representa los detalles del método de autenticación de contraseña registrado para un usuario para la autenticación. |
| phoneMethods | Colección phoneAuthenticationMethod | Representa el teléfono registrado a nombre de un usuario para la autenticación. |
| qrCodePinMethod | qrCodePinAuthenticationMethod | Representa un método de autenticación de código QR registrado a nombre de un usuario para la autenticación. |
| platformCredentialMethods | Colección platformCredentialAuthenticationMethod | Representa una instancia de credenciales de plataforma registrada a nombre de un usuario en Mac OS. |
| resourceAccountKeyAuthenticationMethods | Colección resourceAccountKeyAuthenticationMethod | Representa las credenciales de clave de la cuenta de recursos registradas a nombre de un usuario para la autenticación en dispositivos compartidos. |
| softwareOathMethods | Colección softwareOathAuthenticationMethod | El software OATH aplicaciones de contraseña de un solo uso (TOTP) registradas a un usuario para su autenticación. |
| temporaryAccessPassMethods | colección temporaryAccessPassAuthenticationMethod | Representa un pase de acceso temporal registrado para un usuario para la autenticación a través de códigos de acceso de tiempo limitado. |
| windowsHelloForBusinessMethods | Colección windowsHelloForBusinessAuthenticationMethod | Representa el método de autenticación de Windows Hello para empresas registrado a nombre de un usuario para su 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"
}
}