Работа с API отчетов об использовании методов проверки подлинности

  • Статья

Пространство имен: microsoft.graph

Важно!

API версии /beta в Microsoft Graph могут быть изменены. Использование этих API в производственных приложениях не поддерживается. Чтобы определить, доступен ли API в версии 1.0, используйте селектор версий.

Отчеты об использовании методов проверки подлинности помогают понять, как пользователи в вашей организации используют Microsoft Entra возможности проверки подлинности, такие как многофакторная проверка подлинности (MFA), Self-Service сброс пароля (SSPR) и проверка подлинности без пароля.

Эти отчеты содержат такие сведения, как:

  • Количество зарегистрированных пользователей для каждого метода проверки подлинности
  • Количество пользователей, зарегистрированных для таких функций, как многофакторная проверка подлинности (MFA), Self-Service сброс пароля (SSPR) и проверка подлинности без пароля.
  • Частота сбоев каждого метода проверки подлинности

Лицензии

Для доступа к использованию и аналитическим сведениям требуется лицензия на Microsoft Entra ID P1 или P2. Microsoft Entra сведения о лицензировании многофакторной проверки подлинности и самостоятельного сброса пароля (SSPR) можно найти на сайте цен на Microsoft Entra.

Распространенные запросы

В следующей таблице перечислены некоторые распространенные запросы, которые можно использовать с этим API.

Operation Попробовать в песочнице 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 для всех пользователей.

Связанные материалы