> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md).

# モバイル電話 MFA を設定または削除

このユーザーのモバイル電話 MFA 方法を設定または削除します

### 説明

このユーザーの携帯電話を、通話とテキストメッセージ用の MFA 方法として追加または更新するか、削除します。必要に応じて、変更についてユーザーにメールが送信されます。Tenant が SMS サインインを許可している場合、Microsoft はその番号を登録しようともします。すでに他の誰かがその番号を使用していると警告が表示されますが、MFA 方法は通常そのまま設定され、runbook は実際の状態を確認して報告します。その競合の詳細は、runbook のドキュメント (docs.realmjoin.com) にあります。

### ユーザー通知を有効化

この runbook は任意で、管理者によって携帯電話の MFA 方法が追加、更新、または削除されたことを通知するメールを対象ユーザーに送信できます。これを有効にするには、runbook のカスタマイズでユーザー通知を有効化する必要があります。

この JSON 構成は次のとおりです:

```json
"rjgit-user_security_set-or-remove-mobile-phone-mfa": {
    "parameters": {
        "UserId": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "EmailFrom": {
            "Hide": true
        },
        "ServiceDeskDisplayName": {
            "Hide": true
        },
        "ServiceDeskEmail": {
            "Hide": true
        },
        "ServiceDeskPhone": {
            "Hide": true
        },
        "ServiceDeskPortalUrl": {
            "Hide": true
        },
        "ServiceDeskTicketUrl": {
            "Hide": true
        },
        "LanguageOverride": {
            "Hide": true
        },
        "CallerName": {
            "Hide": true
        }
    }
}
```

runbook のカスタマイズ方法の詳細については、 [Runbook カスタマイズ ガイド](https://docs.realmjoin.com/automation/runbooks/runbook-customization).

### メール送信に関する設定

通知メールの送信はオプションであり、 `NotifyUser` が有効な場合にのみ実行されます。送信者アドレスは `RJReport.EmailSender` テナント設定から取得されます。

この runbook は Microsoft Graph API を使用してメールを送信します。Graph API 経由でメールを送信するには、runbook のカスタマイズで既存のメール アドレスを構成する必要があります。

詳細については、 [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings) を参照してください。

#### メールのブランド設定

レポート メールでは、任意の `RJReport.Branding.*` テナント設定:

* **ヘッダーとフッターの画像** – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB
* **フッター リンク** – フッター画像のリンク先
* **アクセント色とテキスト色** – 6 桁の 16 進値。例: `#0052cc`

これらの設定が構成されていない場合は、既定の RealmJoin のグラフィックと色が使用されます。ダウンロードまたは検証できない画像、または無効な色の値があっても、レポート メールが停止することはありません。代わりに該当する既定値が使用されます。

設定手順と画像要件: [メールのブランド設定](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings#email-branding-optional).

### SMS サインインの競合

Microsoft Graph の phone methods API には、Microsoft が SMS サインイン用にも登録しようとしない形で、電話番号を MFA 専用の方法として追加する方法がありません。Tenant の認証方法ポリシーでユーザーが SMS サインインを有効にされている場合、Graph は電話方法が作成または更新された直後にその登録を試みます。ほかのユーザーがすでにその番号を SMS サインインに使用している場合、Graph は `409 Conflict` およびエラー コード `phoneNumberNotUnique`、ただし通常の MFA 用の電話方法は、それでも通常どおり作成または更新されます。

次の `smsSignInState` プロパティは読み取り専用であり、作成または更新要求では設定できません。SMS サインインは、別個の `enableSmsSignIn` と `disableSmsSignIn` エンドポイントでのみ明示的に切り替えられます。そのため runbook は、そのようなエラーの後に実際の状態を確認し、MFA 方法が割り当てられていた場合は警告付きで成功を報告します。実際に割り当てが失敗した場合は、その番号を保持しているユーザーを検索し、出力でそのユーザー名を示します。

### 場所

ユーザー → セキュリティ → モバイル電話 MFA の設定または削除

**完全な Runbook 名**

rjgit-user\_security\_set-or-remove-mobile-phone-MFA

### 詳細

| プロパティ    | 値                                                                                        |
| -------- | ---------------------------------------------------------------------------------------- |
| バージョン    | 2.3.0                                                                                    |
| 必須モジュール  | <p>RealmJoin.RunbookHelper (>= 0.8.10)<br>Microsoft.Graph.Authentication (>= 2.41.2)</p> |
| スケジュール可能 | いいえ                                                                                      |

### アクセス許可

#### アプリケーションのアクセス許可

* **型**: Microsoft Graph
  * AuditLog.Read.All
    * *競合する SMS サインイン番号を保持しているユーザーを見つけるために userRegistrationDetails を照会します*
  * User.Read.All
    * *対象ユーザーを特定し、競合チェックのために他のユーザーの電話方法をバッチで読み取ります*
  * UserAuthenticationMethod.ReadWrite.All
    * *ユーザーの携帯電話認証方法を設定、更新、または削除します*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *NotifyUser が有効なとき、管理者が MFA 電話を変更したことをユーザーにメールで通知します*
  * Organization.Read.All *(任意 — 機能: メール通知)*
    * *NotifyUser が有効な場合に、通知メール用のテナント表示名を読み取ります*

### パラメーター

#### ユーザー ID

runbook が対象とするユーザーのオブジェクト ID。ポータルが選択されたユーザーから設定します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | true                     |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### phoneNumber

+491701234567 のような E.164 形式の番号。

| プロパティ    | 値      |
| -------- | ------ |
| 必須       | true   |
| 既定値      |        |
| 型        | 文字列    |
| ポータルの表示名 | 携帯電話番号 |

#### 削除

追加または更新すると、その番号が通話とテキストメッセージ用の MFA 方法として保存されます。削除はそれを削除します。

| プロパティ    | 値     |
| -------- | ----- |
| 必須       | false |
| 既定値      | False |
| 型        | ブール値  |
| ポータルの表示名 | アクション |

**ポータル オプション**

| ポータル オプション               | 値     |
| ------------------------ | ----- |
| この番号を MFA 方法として追加または更新する | false |
| 携帯電話の MFA 方法を削除する        | true  |

#### NotifyUser

変更についてユーザーにメール送信するかどうか。runbook のカスタマイズで事前設定されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | False                    |
| 型        | ブール値                     |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### EmailFrom

通知メールの送信者アドレス。テナント設定 RJReport.EmailSender から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingHeaderImageUrl

レポート メールのヘッダー画像（HTTPS URL、PNG/JPEG/GIF、最大 200 KB）。テナント設定 RJReport.Branding.HeaderImageUrl から取得されます。空の場合は既定の RealmJoin のヘッダーが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingFooterImageUrl

レポート メールのフッター画像（HTTPS URL、PNG/JPEG/GIF、最大 200 KB）。テナント設定 RJReport.Branding.FooterImageUrl から取得されます。空の場合は既定の RealmJoin のフッターが使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingFooterLink

レポート メールのフッター画像の背後にあるリンク先。テナント設定 RJReport.Branding.FooterLink から取得されます。空の場合は realmjoin.com が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingAccentColor

レポート メールのアクセント色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.AccentColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### BrandingTextColor

レポート メールのテキスト色を 6 桁の 16 進値で指定します。テナント設定 RJReport.Branding.TextColor から取得されます。空または無効な場合は RealmJoin の既定値が使用されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ServiceDeskDisplayName

メールに表示されるサービスデスク名。テナント設定 RJReport.ServiceDesk\_DisplayName から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ServiceDeskEmail

メールに表示されるサービスデスクのメールアドレス。テナント設定 RJReport.ServiceDesk\_EMail から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ServiceDeskPhone

メールに表示されるサービスデスクの電話番号。テナント設定 RJReport.ServiceDesk\_Phone から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ServiceDeskPortalUrl

メールに表示されるサービスデスクポータルへのリンク。テナント設定 RJReport.ServiceDesk\_PortalUrl から取得されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### ServiceDeskTicketUrl

メールに表示される、このリクエストのチケットへのリンク。各実行ごとまたは runbook のカスタマイズで事前設定されます。空の場合はリンクなし。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

#### LanguageOverride

メール言語を DE または EN に強制します。空欄の場合はユーザーの使用場所から言語を選択します。runbook のカスタマイズで事前設定されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      |                          |
| 型        | 文字列                      |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

[Runbook リファレンスの概要に戻る](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/runbook-references/user/security/set-or-remove-mobile-phone-mfa.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
