phoneMethod を作成する

名前空間: microsoft.graph

ユーザーの新しい 電話認証方法 を追加します。 ユーザーは、 phoneType プロパティでキャプチャされた、各種類の電話を 1 つだけ持つことができます。 つまり、たとえば、既存のmobile電話を持つユーザーにmobile電話を追加すると失敗します。 さらに、ユーザーは、alternateMobile電話を追加する前に、常にmobile電話を持っている必要があります。

電話番号を追加すると、Azure Multi-Factor Authentication (MFA) とセルフサービス パスワード リセット (SSPR) の両方で使用できるようになります (有効な場合)。

さらに、ユーザーがポリシーによって SMS サインインを使用できるように有効になっていて、 mobile 番号が追加された場合、システムはそのシステムで使用する番号の登録を試みます。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) UserAuthenticationMethod.ReadWrite.All UserAuthenticationMethod.ReadWrite
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション UserAuthenticationMethod.ReadWrite.All 注意事項なし。

委任されたシナリオの場合、管理者には、少なくとも 認証管理者 または 特権認証管理者Microsoft Entra ロールが必要です。

ユーザーは自分のアカウントに電話認証方法を追加できません。

HTTP 要求

別のユーザーのアカウントに電話認証方法を追加します。

POST /users/{id | userPrincipalName}/authentication/phoneMethods

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、 phoneAuthenticationMethod オブジェクトの JSON 表現を指定します。 JSON には phoneNumberphoneTypeを含める必要がありますが、読み取り専用の smsSignInState は含まれません。

プロパティ 種類 説明
phoneNumber String 携帯ショートメール(SMS) または認証通話用の電話番号。 電話番号は +{country code} {number}x{extension} 形式を使用し、内線は省略可能です。 たとえば、+1 5555551234 または +1 5555551234x123 は有効です。 番号が必要な形式と一致しない場合、作成または更新時に拒否されます。
phoneType String 使用可能な値は、 mobilealternateMobile、および officeです。

応答

成功した場合、このメソッドは応答コード 201 Created と、応答本文に新しい phoneAuthenticationMethod オブジェクトを返します。

要求

要求の例を次に示します。

POST https://graph.microsoft.com/v1.0/users/kim@contoso.com/authentication/phoneMethods
Content-type: application/json

{
  "phoneNumber": "+1 2065555555",
  "phoneType": "mobile"
}

応答

応答の例を下に示します。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

HTTP/1.1 201 Created
Content-type: application/json

{
  "phoneNumber": "+1 2065555555",
  "phoneType": "phoneType-value",
  "smsSignInState": "ready",
  "id": "3179e48a-750b-4051-897c-87b9720928f7"
}