> 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 メソッドとして追加または更新し、または削除します。必要に応じて、ユーザーに変更に関するメールが送信されます。テナントで 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
        }
    }
}
```

ランブックのカスタマイズ方法の詳細については、 [ランブック カスタマイズ ガイド](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 専用メソッドとして追加する方法はありません。テナントの認証方法ポリシーでユーザーが 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
    * *userRegistrationDetails を照会して、競合する SMS サインイン番号を保持しているユーザーを特定します*
  * User.Read.All
    * *対象ユーザーを解決し、他のユーザーの電話メソッドを一括読み取りして競合を確認します*
  * UserAuthenticationMethod.ReadWrite.All
    * *ユーザーのモバイル電話認証メソッドを設定、更新、または削除します*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *NotifyUser が有効な場合、管理者が MFA 用電話番号を変更したことをユーザーにメールで通知します*
  * Organization.Read.All *(任意 — 機能: メール通知)*
    * *NotifyUser が有効な場合、通知メール用にテナントの表示名を読み取ります*

### パラメーター

#### ユーザー ID

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

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | true                      |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### phoneNumber

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

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

#### 削除

Add または update は、その番号を通話と SMS メッセージ用の MFA メソッドとして保存します。Remove はそれを削除します。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | 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

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

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

#### LanguageOverride

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

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      |                           |
| 種類       | 文字列                       |
| ポータルで非表示 | はい (Runbook のカスタマイズで事前設定) |

[Runbook リファレンスの概要に戻る](/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.