フィードバック 編集

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

  • [アーティクル]

名前空間: microsoft.graph

重要

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

認証方法の使用状況レポートは、組織内のユーザーが多要素認証 (MFA)、Self-Service Password Reset (SSPR)、パスワードレス認証などの Azure Active Directory (Azure AD) 機能を使用する方法を理解するのに役立ちます。

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

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

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント) Reports.Read.All、AuditLog.Read.All
委任 (個人用 Microsoft アカウント) サポートされていません。
アプリケーション Reports.Read.All、AuditLog.Read.All

API にアクセスするには、次 のいずれかの役割が 必要です。

  • レポート閲覧者
  • セキュリティ閲覧者
  • セキュリティ管理者
  • グローバル閲覧者
  • グローバル管理者

ライセンス

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

次の手順