反馈 编辑

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

  • 项目

命名空间：microsoft.graph

重要

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

身份验证方法使用情况报告可帮助您了解组织中用户使用 Azure Active Directory (Azure AD) 功能的方式，如多重身份验证 (MFA) 、Self-Service 密码重置 (SSPR) 和无密码身份验证。

这些报告提供以下信息：

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

权限

以下权限需要调用此 API。要了解详细信息，包括如何选择权限，请参阅权限。

权限类型 权限（从最低特权到最高特权）
委派（工作或学校帐户） Reports.Read.All、AuditLog.Read.All
委派（个人 Microsoft 帐户） 不支持。
应用程序 Reports.Read.All、AuditLog.Read.All

若要访问 API， 需要以下角色之 一：

  • 报表阅读人员
  • 安全读者
  • 安全管理员
  • 全局读取者
  • 全局管理员

许可证

需要Azure AD Premium P1 P2 许可证才能访问使用情况和见解。 Azure AD SSPR) 网站中提供多重身份验证和自助服务密码重置 (SSPR Azure Active Directory许可信息。

常见请求

下表列出了可用于此 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 注册详细信息。

后续步骤