Edit

authentication resource type

  • Article

Namespace: microsoft.graph

Important

APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Exposes authentication sign-in preferences and relationships that represent the authentication methods supported by Microsoft Entra ID that can be configured for users.

Inherits from entity.

Methods

Method Return type Description
Get authentication sign-in preferences authentication Get the authentication sign-in preferences of a user. This includes whether the user is enabled for system preferred authentication and the users preferred multi-factor authentication method.
Update authentication sign-in preferences authentication Update the authentication sign-in preferences of a user.

Properties

Property Type Description
id String Unique identifier for the authentication.
signInPreferences signInPreferences The settings and preferences for to the sign-in experience of a user. Use this property to configure the user's default multifactor authentication (MFA) method.

Relationships

Relationship Type Description
emailMethods emailAuthenticationMethod collection Represents the email addresses registered to a user for authentication.
fido2Methods fido2AuthenticationMethod collection Represents the FIDO2 security keys registered to a user for authentication.
methods authenticationMethod collection Represents all authentication methods registered to a user.
microsoftAuthenticatorMethods microsoftAuthenticatorAuthenticationMethod collection The details of the Microsoft Authenticator app registered to a user for authentication.
passwordlessMicrosoftAuthenticatorMethods passwordlessMicrosoftAuthenticatorAuthenticationMethod collection Represents the Microsoft Authenticator Passwordless Phone Sign-in methods registered to a user for authentication.
passwordMethods passwordAuthenticationMethod collection Represents the details of the password authentication method registered to a user for authentication.
phoneMethods phoneAuthenticationMethod collection Represents the phone registered to a user for authentication.
temporaryAccessPassMethods temporaryAccessPassAuthenticationMethod collection Represents a Temporary Access Pass registered to a user for authentication through time-limited passcodes.
windowsHelloForBusinessMethods windowsHelloForBusinessAuthenticationMethod collection Represents the Windows Hello for Business authentication method registered to a user for authentication.

JSON representation

The following is a JSON representation of the resource.

{
  "@odata.type": "#microsoft.graph.authentication",
  "id": "String (identifier)",
  "signInPreferences": {
    "@odata.type": "microsoft.graph.signInPreferences"
  }
}