使用身份验证方法使用情况报告 API

命名空间:microsoft.graph

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用,请使用 版本 选择器。

身份验证方法使用情况报告可帮助你了解组织中的用户如何使用Microsoft Entra身份验证功能,例如多重身份验证 (MFA) 、Self-Service 密码重置 (SSPR) 和无密码身份验证。

这些报表提供如下信息:

  • 为每种身份验证方法注册了多少用户
  • 有多少用户注册了多重身份验证 (MFA) 、Self-Service 密码重置 (SSPR) 和无密码身份验证等功能。
  • 每个身份验证方法的失败率

许可证

访问使用情况和见解需要Microsoft Entra ID P1 或 P2 许可证。 Microsoft Entra多重身份验证和自助密码重置 (SSPR) 许可信息,请参阅Microsoft Entra定价站点

常见请求

下表列出了可用于此 API 的一些常见请求。

操作 在 Graph 浏览器中试用 说明
getCredentialUserRegistrationcount GET /credentialuserregistrationcount 获取注册自助密码重置和 MFA 的用户数。
getCredentialUsageSummary GET /credentialusagesummary 获取使用自助密码重置的用户数。
credentialUserRegistrationDetails (已弃用) GET /credentialuserregistrationdetails 获取自助密码重置和 MFA 注册活动的用户详细信息。
userCredentialUsageDetails GET /usercredentialusagedetails 获取所有自助式密码重置活动的用户详细信息。
usersRegisteredByFeature GET /authenticationMethods/usersRegisteredByFeature 获取能够进行多重身份验证、自助式密码重置和无密码身份验证的用户数。
usersRegisteredByMethod GET /authenticationMethods/usersRegisteredByMethod 获取为每种身份验证方法注册的用户数。
userRegistrationDetails GET /authenticationMethods/userRegistrationDetails 获取所有用户的 MFA 注册详细信息。