認証方法の使用状況レポート API の操作

  • [アーティクル]

名前空間: microsoft.graph

重要

Microsoft Graph の /beta バージョンの API は変更される可能性があります。 実稼働アプリケーションでこれらの API を使用することは、サポートされていません。 v1.0 で API を使用できるかどうかを確認するには、Version セレクターを使用します。

認証方法の使用状況レポートは、多要素認証 (MFA)、Self-Service パスワード リセット (SSPR)、パスワードレス認証などのMicrosoft Entra認証機能をorganizationのユーザーがどのように使用しているかを理解するのに役立ちます。

これらのレポートは、次のような情報を提供します。

  • 認証方法ごとに登録されているユーザーの数
  • 多要素認証 (MFA)、Self-Service パスワード リセット (SSPR)、パスワードレス認証などの機能に登録されているユーザーの数。
  • 各認証方法の失敗率

ライセンス

使用状況と分析情報にアクセスするには、Microsoft Entra ID P1 または P2 ライセンスが必要です。 多要素認証とセルフサービス パスワード リセット (SSPR) のライセンス情報Microsoft Entraは、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 登録の詳細を取得します。

関連コンテンツ