Partager via


type de ressource d’authentification

Espace de noms: microsoft.graph

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Expose les états de méthode d’authentification pour les utilisateurs et les relations qui représentent les méthodes d’authentification prises en charge par Microsoft Entra ID. Les états des méthodes d’authentification suivants sont pris en charge :

  • Préférences de connexion d’un utilisateur (authentification multifacteur préférée par le système)
  • État MFA d’un utilisateur (MFA par utilisateur)

Hérite de l’entité.

Méthodes

Méthode Type de retour Description
Obtenir authentification Obtenez les états d’authentification d’un utilisateur, tels que ses préférences de connexion et son état MFA.
Mettre à jour authentification Mettez à jour les états d’authentification d’un utilisateur, tels que ses préférences de connexion et son état MFA.

Propriétés

Propriété Type Description
id String Identificateur unique. En lecture seule.
conditions requises strongAuthenticationRequirements Les paramètres et les préférences pour l’authentification multifacteur par utilisateur Microsoft Entra.
signInPreferences signInPreferences Paramètres et préférences pour l’expérience de connexion d’un utilisateur. Utilisez cette propriété pour configurer la méthode d’authentification multifacteur (MFA) par défaut de l’utilisateur.

Relations

Relation Type Description
emailMethods Collection emailAuthenticationMethod Représente les adresses e-mail inscrites auprès d’un utilisateur pour l’authentification.
fido2Methods collection fido2AuthenticationMethod Représente les clés de sécurité FIDO2 inscrites auprès d’un utilisateur pour l’authentification.
hardwareOathMethods collection hardwareOathAuthenticationMethod Appareils de mot de passe à usage unique (TOTP) basés sur le temps matériel attribués à un utilisateur pour l’authentification.
méthode collection authenticationMethod Représente toutes les méthodes d’authentification inscrites auprès d’un utilisateur.
microsoftAuthenticatorMethods Collection microsoftAuthenticatorAuthenticationMethod Détails de l’application Microsoft Authenticator inscrite auprès d’un utilisateur pour l’authentification.
opérations collection longRunningOperation Représente la status d’une opération de longue durée, telle qu’une opération de réinitialisation de mot de passe.
passwordlessMicrosoftAuthenticatorMethods collection passwordlessMicrosoftAuthenticatorAuthenticationMethod Représente les méthodes de connexion par téléphone sans mot de passe Microsoft Authenticator inscrites auprès d’un utilisateur pour l’authentification.
passwordMethods collection passwordAuthenticationMethod Représente les détails de la méthode d’authentification par mot de passe inscrite auprès d’un utilisateur pour l’authentification.
phoneMethods Collection phoneAuthenticationMethod Représente le téléphone inscrit auprès d’un utilisateur pour l’authentification.
softwareOathMethods collection softwareOathAuthenticationMethod Le logiciel OATH time-based one-time-based one-time password (TOTP) applications inscrites auprès d’un utilisateur pour l’authentification.
temporaryAccessPassMethods collection temporaryAccessPassAuthenticationMethod Représente un passe d’accès temporaire inscrit auprès d’un utilisateur pour l’authentification par le biais de codes secrets limités dans le temps.
windowsHelloForBusinessMethods Collection windowsHelloForBusinessAuthenticationMethod Représente la méthode d’authentification Windows Hello Entreprise inscrite auprès d’un utilisateur pour l’authentification.

Représentation JSON

La représentation JSON suivante montre le type de ressource.

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