使用身份验证方法使用情况报告 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 注册详细信息。 |
相关内容
- 了解如何部署Microsoft Entra自助式密码重置。
- 了解如何部署Microsoft Entra多重身份验证。
- 了解如何启用 组合安全信息注册。
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈