Microsoft Entra認証方法 API の概要

  • [アーティクル]

名前空間: microsoft.graph

重要

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

認証方法は、ユーザーがMicrosoft Entra IDで認証する方法です。 Microsoft Entra IDの認証方法には、パスワードと電話 (SMS や音声通話など) が含まれています。これは、現在 Microsoft Graph で管理可能であり、FIDO2 セキュリティ キーや Microsoft Authenticator アプリなど、多くのユーザーが管理できます。 認証方法は、プライマリ、セカンドファクター、およびステップアップ認証で使用され、セルフサービスパスワードリセット (SSPR) プロセスでも使用されます。

認証方法 API は、ユーザーの認証方法を管理するために使用されます。 以下に例を示します。

  • ユーザーに電話番号を追加できます。 その後、ユーザーがポリシーで使用できるようにする場合は、その電話番号を SMS と音声通話の認証に使用できます。
  • その番号を更新するか、ユーザーから削除できます。
  • SMS サインインの番号を有効または無効にすることができます。
  • ユーザーのパスワードをリセットできます。
  • ユーザーの FIDO2 セキュリティ キーの詳細を取得し、ユーザーがキーを紛失した場合は削除できます。
  • ユーザーの Microsoft Authenticator 登録の詳細を取得し、ユーザーが電話を紛失した場合は削除できます。
  • ユーザーのWindows Hello for Business登録の詳細を取得し、ユーザーがデバイスを紛失した場合は削除できます。
  • ユーザーにメール アドレスを追加できます。 ユーザーは、Self-Service パスワード リセット (SSPR) プロセスの一部として、その電子メールを使用できます。
  • そのメールを更新することも、ユーザーから削除することもできます。

監査またはセキュリティのチェック目的でユーザーの作成全体を反復処理する必要があるシナリオでは、認証方法 API を使用することはお勧めしません。 これらの種類のシナリオでは、 認証方法の登録と使用状況レポート API を使用することをお勧めします。

Microsoft Graph で管理できる認証方法は何ですか?

認証方法 説明 例
emailAuthenticationMethod 電子メール アドレスは、Self-Service パスワード リセット (SSPR) プロセスの一部としてユーザーが使用できます。 ユーザーの認証メール アドレスを確認します。 ユーザーにメール アドレスを追加、更新、または削除します。
fido2AuthenticationMethod FIDO2 セキュリティ キーは、ユーザーがMicrosoft Entra IDにサインインするために使用できます。 紛失した FIDO2 セキュリティ キーを削除します。
microsoftAuthenticatorAuthenticationMethod Microsoft Authenticator を使用すると、ユーザーはサインインしたり、多要素認証を実行してMicrosoft Entra ID Microsoft Authenticator 認証方法を削除します。
passwordAuthenticationMethod パスワードは現在、Microsoft Entra IDの既定のプライマリ認証方法です。 ユーザーのパスワードを再設定します
phoneAuthenticationMethod ユーザーが SMS または音声通話 を使用して認証するために電話を使用できます (ポリシーで許可されています)。 ユーザーの認証電話番号を確認します。 ユーザーに電話番号を追加、更新、または削除します。 SMS サインインのプライマリ携帯電話を有効または無効にします。
platformCredentialAuthenticationMethod プラットフォーム資格情報は、Mac OS デバイス上のユーザーのサインイン認証方法です。 ユーザーのプラットフォーム資格情報を確認します。 ユーザーのプラットフォーム資格情報を削除します。
softwareOathAuthenticationMethod OATH 仕様をサポートし、1 回限りのコードを提供するアプリケーションを使用して、ユーザーが多要素認証を実行できるようにします。 ユーザーに割り当てられたソフトウェア トークンを取得および削除します。
temporaryaccesspassauthenticationmethod 一時的なアクセス パスは、強力な資格情報として機能し、パスワードレス資格情報のオンボードを許可する時間制限付きパスコードです。 ユーザーに対して新しい一時アクセス パスを設定します。
windowsHelloForBusinessAuthenticationMethod Windows Hello for Businessは、Windows デバイス上のパスワードレス サインイン方法です。 ユーザーがサインインを有効にしているデバイスWindows Hello for Business表示します。 Windows Hello for Business資格情報を削除します。
passwordlessmicrosoftauthenticatorauthenticationmethod (非推奨) Microsoft Authenticator パスワードレス電話サインインは、ユーザーがサインインしてMicrosoft Entra ID パスワードレス電話サインイン認証方法を削除します。

Microsoft Graph betaでは、次の認証方法はまだサポートされていません。

認証方法 説明 例
ハードウェア トークン ユーザーが 1 回限りのコードを提供する物理デバイスを使用して多要素認証を実行できるようにします。 ユーザーに割り当てられたハードウェア トークンを取得します。
セキュリティに関する質問と回答 セルフサービス パスワード リセットを実行するときに、ユーザーが ID を検証できるようにします。 ユーザーが登録したセキュリティの質問を削除します。

多要素認証を再登録する必要があります

ユーザーが次回サインインするときに新しい多要素認証を設定するように要求するには、個々の DELETE 認証方法操作を呼び出して、各ユーザーの現在の認証方法を削除します。 ユーザーにこれ以上の方法がない場合は、次に強力な認証が必要な場所にサインインするときに登録するように求められます。

次の手順