> 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/org/security/sync-mfa-secure-users-to-group_scheduled.md).

# MFA セキュア ユーザーをグループに同期（スケジュール済み）

安全な MFA 方法を登録したユーザーでグループを満たす

{% hint style="info" %}
これはスケジュール実行の runbook です。単一のオブジェクトによってトリガーされるのではなく、繰り返しスケジュールで実行されるように設計されています。詳細は [スケジューリング](https://docs.realmjoin.com/ja/zi-dong-hua/runbooks/scheduling.md) runbook のスケジュールを構成する方法の詳細は。
{% endhint %}

### 説明

パスキーや Microsoft Authenticator アプリなど、少なくとも 1 つの安全な認証方法を登録したユーザーと Entra ID グループを同期状態に保ちます。安全な方法を失ったユーザーは削除され、管理者、除外グループ、および個別ユーザーは除外できます。たとえば、そのグループがセルフサービス パスワード リセットを制御している場合です。ドライ ランでは変更内容のみを表示し、実行ごとに概要と変更内容を Output Data として書き込みます。レポートはメールで送信することも、ダウンロード リンクとして提供することもできます。オプションの詳細は runbook のドキュメント (docs.realmjoin.com) にあります。

### 仕組み

runbook は Entra ID の [認証方法登録レポートを読み取り](https://learn.microsoft.com/en-us/graph/api/authenticationmethodsroot-list-userregistrationdetails) (`userRegistrationDetails`) を参照し、ターゲット グループをすべての **メンバー ユーザー** に対して照合します。

* ユーザーは、登録済みの方法の少なくとも 1 つが、構成された **安全な** セットに含まれているときに適格と見なされます。
* 次の **厳格モード** (`SecureOnly`が有効な場合は、さらに **安全でない** セットに含まれる方法を登録していない必要があります。たとえば、SMS 要素も保持しているパスキー ユーザーは適格ではありません。
* まだグループ メンバーではない適格ユーザーは追加され、もはや適格でないメンバーは削除されます (ミラー同期)。
* ゲスト ユーザーは追加も削除もされません。ユーザー以外のグループ メンバー (デバイス、Service Principals、ネストされたグループ) は変更されません。

ターゲット グループは、この runbook のみによって管理される必要があります。

### 安全な方法のグループ

各トグルは、どの `methodsRegistered` 値を安全と見なすかを制御します:

| トグル                           | 既定値 | 対象となる値                                                                               |
| ----------------------------- | --- | ------------------------------------------------------------------------------------ |
| Passkeys / FIDO2 Security Key | オン  | `fido2SecurityKey`, `passKeyDeviceBound`, `passKeyDeviceBoundAuthenticator`          |
| プラットフォーム資格情報                  | オン  | `windowsHelloForBusiness`, `passKeyDeviceBoundWindowsHello`, `macOsSecureEnclaveKey` |
| Microsoft Authenticator アプリ   | オン  | `microsoftAuthenticatorPush`, `microsoftAuthenticatorPasswordless`                   |
| ソフトウェア OTP                    | オフ  | `softwareOneTimePasscode`                                                            |
| ハードウェア OTP                    | オフ  | `hardwareOneTimePasscode`                                                            |
| 証明書ベースの認証                     | オン  | `certificateBasedAuthentication`                                                     |

### 厳格モード (SecureOnly)

厳格モードを有効にすると、次の組み込みの安全でない方法のいずれかを持つユーザーは適格になりません:

`mobilePhone`, `alternateMobilePhone`, `officePhone`, `email`, `securityQuestion`

ある方法が安全なセットと安全でないセットの両方に入る場合 (上書きパラメーター経由でのみ可能)、安全でない方が優先されます — そのようなユーザーは厳格モードでは決して適格になりません。runbook は起動時にこれを警告します。

### 除外

除外されたユーザーは、登録済みの方法に関係なく決して適格になりません。ターゲット グループに追加されることはなく、すでにメンバーであれば削除されます。ユーザーごとのレポートでは、その理由が `ExclusionReason` 列に表示されます。

#### 管理者ユーザーを除外する (`ExcludeAdmins`、既定でオン)

Entra ID ディレクトリ ロールを持つユーザーは除外されます。対象には次が含まれます:

* **アクティブなロール割り当て** (`roleManagement/directory/roleAssignments`)
* **PIM 対象の割り当て** (`roleManagement/directory/roleEligibilitySchedules`、Entra ID P2 が必要です — Graph がライセンス不足を報告した場合、runbook はアクティブな割り当てにフォールバックし、警告を記録します。それ以外のエラーがあると、グループが変更される前にジョブは失敗します)
* **ロール割り当て可能グループ**：ロールを保持しているグループは、推移的なユーザー メンバーへ展開されます

背景: ターゲット グループが **SSPR** を制御し、SSPR 管理者ポリシーが無効な場合、グループ内の管理者は 2 つの SSPR 方法が必要になると、なおも 2 番目の要素を登録するよう強制されます。管理者をグループ外にしておくことで、これを回避できます。

このオプションには、マネージド ID に対する追加の Graph 権限 `RoleManagement.Read.Directory` が必要です。

#### 除外グループ (`ExcludeGroupId`、オプション)

構成されたグループの推移的なユーザー メンバーが除外されます — これは、この同期によって決して管理されるべきでないアカウント向けです。たとえば **ブレークグラス アカウント** または **サービス アカウント**などです。ネストされたグループは尊重されます。除外グループはターゲット グループ自身であってはなりません。

#### 個別に除外されたユーザー (`ExcludeUserIds`、オプション)

個々のユーザーは、専用の除外グループを維持するほどではない一時的な除外のために、複数ユーザー ピッカーから直接除外できます。リストではユーザー **オブジェクト ID** と **ユーザー プリンシパル名**  (UPN) を受け付けます。解決できないエントリ (例: 削除済みアカウント) は警告を記録して無視されるため、古いエントリがスケジュール済み同期を壊すことはありません。

#### Runbook Customization による除外の管理 (ピッカーを使わない場合)

両方の除外パラメーターは、次を通じて事前に中央で設定できます [JSON ベースの Runbook Customization](https://docs.realmjoin.com/automation/runbooks/runbook-customization#json-based-customizing) (RealmJoin ポータル: **Settings** → **Runbook Customizations**) — 除外対象が Tenant 全体で固定されており、runbook の開始時やスケジュール時に毎回手動で選択したくない場合に便利です:

```json
{
    "Runbooks": {
        "rjgit-org_security_sync-mfa-secure-users-to-group_scheduled": {
            "Parameters": {
                "ExcludeGroupId": {
                    "DefaultValue": "00000000-0000-0000-0000-000000000000",
                    "Hide": true
                },
                "ExcludeUserIds": {
                    "DefaultValue": [
                        "11111111-1111-1111-1111-111111111111",
                        "breakglass@contoso.com"
                    ],
                    "Hide": true
                }
            }
        }
    }
}
```

* **ExcludeGroupId** 単一のグループ **オブジェクト ID**  (GUID) をプレーン文字列として受け取ります — Entra admin center または RealmJoin ポータルのグループ概要ページからコピーしてください。
* **ExcludeUserIds** JSON **文字列の配列**を受け取ります。各エントリはユーザー **オブジェクト ID** または **UPN**にできます。エントリはトリムされ、重複排除されます。runbook は起動時にそれらを解決します。
* **推奨:** 除外が Runbook Customization で管理されている場合は、 `"Hide": true` もパラメーターに設定してください (上記の例のように)。これにより開始フォームから完全に削除されるため、中央で構成された除外を UI で開始時またはスケジュール時に上書きできなくなります。 `Hide`がない場合、構成された値は事前入力として表示されるだけで、そこで変更することもできます。

### 方法分類リファレンス

カンマ区切りの上書き文字列を作成するときは、この表の正確な Graph 値を使用してください:

| `methodsRegistered` 値                | わかりやすい名前                                  | 分類    | トグルでカバー (既定)                     |
| ------------------------------------ | ----------------------------------------- | ----- | -------------------------------- |
| `fido2SecurityKey`                   | FIDO2 Security Key                        | 安全    | Passkeys / FIDO2 (オン)            |
| `passKeyDeviceBound`                 | パスキー (デバイス バインド)                          | 安全    | Passkeys / FIDO2 (オン)            |
| `passKeyDeviceBoundAuthenticator`    | Microsoft Authenticator のパスキー             | 安全    | Passkeys / FIDO2 (オン)            |
| `windowsHelloForBusiness`            | Windows Hello for Business                | 安全    | プラットフォーム資格情報 (オン)                |
| `passKeyDeviceBoundWindowsHello`     | Windows Hello のパスキー                       | 安全    | プラットフォーム資格情報 (オン)                |
| `macOsSecureEnclaveKey`              | macOS のプラットフォーム資格情報                       | 安全    | プラットフォーム資格情報 (オン)                |
| `microsoftAuthenticatorPush`         | Microsoft Authenticator (プッシュ通知)          | 安全    | Microsoft Authenticator アプリ (オン) |
| `microsoftAuthenticatorPasswordless` | Microsoft Authenticator (パスワードレスの電話サインイン) | 安全    | Microsoft Authenticator アプリ (オン) |
| `softwareOneTimePasscode`            | ソフトウェア OATH トークン (TOTP アプリ)               | 安全    | ソフトウェア OTP (オフ)                  |
| `hardwareOneTimePasscode`            | ハードウェア OATH トークン                          | 安全    | ハードウェア OTP (オフ)                  |
| `certificateBasedAuthentication`     | 証明書ベースの認証                                 | 安全    | 証明書ベースの認証 (オン)                   |
| `mobilePhone`                        | 電話 (SMS / 音声通話)                           | 安全でない | 組み込みの安全でない一覧                     |
| `alternateMobilePhone`               | 代替電話 (音声通話)                               | 安全でない | 組み込みの安全でない一覧                     |
| `officePhone`                        | 勤務先電話 (音声通話)                              | 安全でない | 組み込みの安全でない一覧                     |
| `email`                              | メール (SSPR のみ)                             | 安全でない | 組み込みの安全でない一覧                     |
| `securityQuestion`                   | セキュリティの質問 (SSPR のみ)                       | 安全でない | 組み込みの安全でない一覧                     |
| `temporaryAccessPass`                | Temporary Access Pass                     | 中立    | 決して適格にならず、決して失格にもならない            |

不明または将来の Graph 値は、上書きパラメーターで明示的に指定されていない限り、中立として扱われます。

### 上書きパラメーター

両方の上書きパラメーターは既定で非表示であり、RealmJoin runbook のカスタマイズ向けです:

* **SecureMethodsOverride** — セキュア セットを定義する `methodsRegistered` 値のカンマ区切りリスト。設定すると、 **すべての** 方法グループのトグルは無視されます。例: `fido2SecurityKey,passKeyDeviceBound,passKeyDeviceBoundAuthenticator,windowsHelloForBusiness`
* **UnsecureMethodsOverride** — 組み込みの安全でない一覧を置き換える、カンマ区切りのリスト。厳格モードでのみ評価されます。例: `mobilePhone,alternateMobilePhone,officePhone,email,securityQuestion,softwareOneTimePasscode`

不明な値は警告を生成しますが、それでも評価されるため、将来の Graph 値はこのドキュメントが追いつく前に使用できます。

### 出力データ

実行ごとに、その結果は RealmJoin ポータルの Output Data タブに書き込まれ、各テーブルを Excel にエクスポートできます:

* *概要* — 選択した構成と結果数: レポート エントリ、評価されたメンバー ユーザー、適格ユーザー、以前のメンバー、および追加・削除されたユーザー (ドライ ラン モードでは追加または削除される予定のユーザー。失敗した追加と削除は別途表示されます)。すでにメンバーだったユーザーは追加として、すでにいなくなっていたユーザーは削除としてカウントされます。
* *変更* — グループに追加または削除されたすべてのユーザー (ドライ ラン モードでは保留中の変更) と、ユーザーごとの方法詳細

*変更* は、同名のレポート ファイルとワークシートと同じ行と列を持ちます。変更がない実行では、 *変更* テーブルの代わりにステータス行が表示されます。各メンバー ユーザーの評価はレポート ファイル (*All Users*) にのみあります。毎回の実行でユーザーごとに 1 行あると、大規模 Tenant のジョブ出力が大きくなりすぎるためです。

### レポートの配信

次の **レポートの配信** 実行ダイアログのオプションにより、レポートをファイルとしても配信するかどうかが決まります。特に、最初の実行を確認する場合に便利です (理想的にはドライ ラン モードと組み合わせます):

* *出力データのみ* (既定): レポート ファイルなし、メールなし。
* *レポートもメール送信*: レポートを受信者のメール アドレスに送信します。その場合、メール アドレスは必須フィールドになります。 `RJReport.EmailSender` Tenant 設定が必要です ( [RealmJoin Report Settings のドキュメント](https://docs.realmjoin.com/automation/runbooks/runbook-report-settings)).
* *ダウンロード リンクも作成する*: レポート ファイルを Azure Storage Account にアップロードし、時間制限付きのダウンロード リンクを返します ( `RJReport.StorageAccount.*` Tenant 設定を使用します)。
* *レポートもメール送信とダウンロードリンク*: 両方。

メールまたはダウンロード リンクを使用すると、 **レポート ファイル形式** CSV ファイル、Excel ブック、またはその両方を選択します。このオプションにより、非表示パラメーター `SendEmail` と `CreateDownloadLink`が設定されます。スケジュールや、これらのパラメーターを直接渡す API 呼び出しは、従来どおり機能します。

が存在する前に作成されたスケジュールは、配信設定を保持します。そのようなスケジュールを編集用に開くと、オプションは **レポートの配信** 表示されますが、保存済みのメールまたはダウンロード リンクは有効なままです。スケジュールの内容とダイアログが一致するように、保存する前に配信をもう一度選択してください。 *出力データのみ* と表示されます

レポート ファイルは、メールまたはダウンロード リンクが選択された場合にのみ生成されます。レポートは次で構成されます:

* **mfa-secure-users-group-sync-changes.csv** — 実行された (またはドライ ランでは保留中の) すべての変更と、ユーザーごとの方法詳細
* **mfa-secure-users-group-sync-all-users.csv** — 各メンバー ユーザーの評価: 登録済みの方法、安全/安全でないの分類、適格性、除外理由、およびグループ メンバーシップ
* **mfa-secure-users-group-sync-report.xlsx** — 同じデータを整形済み Excel ブックとして: 選択したパラメーターと結果数を含む「Info」表紙シート、「Changes」ワークシート (追加されたユーザーは緑で、削除されたユーザーは赤で強調表示) および「All Users」ワークシート

大規模 Tenant では、元の CSV ファイルがメール添付サイズの上限を超える場合があります (Graph は合計約 4 MB でメールを拒否します)。CSV ファイルが 2.5 MB の予算を超えると、メールは Excel ブックのみを添付して送信されます (そこには圧縮形式で完全なデータが含まれます) そして省略についての注記が付きます。サイズ超過による送信失敗も、自動的にブックのみで再試行されます。ダウンロード リンクのアップロードには、サイズに関係なく常にすべてのファイルが含まれます。

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

レポート メールでは、任意の `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).

### 注意事項と制限

* 登録レポートには **Entra ID P1 または P2** ライセンスが必要です。
* PIM 対象のロール割り当て (管理者の除外) には **Entra ID P2** ライセンスが必要です — それがない場合、除外されるのはアクティブなロール割り当てのみです。
* リストの読み取りに失敗すると (登録レポート、ロール割り当て、ロール割り当て可能グループまたは除外グループのメンバー、ターゲット グループの現在のメンバー)、グループが変更される前にジョブは失敗するため、不完全なデータで同期が実行されることはありません。
* レポートには **無効** またはソフト削除されたユーザーは含まれません — そのようなアカウントは次回の実行でグループから削除されます。
* レポート データは最近の登録変更より遅れる場合があります。新しく登録された方法が反映されるまでに 1 回の同期サイクルが必要になることがあります。
* runbook は、大規模 Tenant (20k+ ユーザー) をページ区切りのレポート読み取りとバッチ化されたグループ書き込みで処理し、自動スロットリング再試行を行います。

### スケジューリング

同期は冪等です — 単一の定期スケジュール (例: 毎日) でグループを最新に保ち、部分的な失敗後の再実行は自己修復します。推奨: まず **ドライ ラン (WhatIf)** を有効にして実行出力を確認してから、本番モードで runbook をスケジュールしてください。

### 場所

Organization → Security → Sync MFA Secure Users To Group (Scheduled)

**完全な Runbook 名**

rjgit-org\_security\_sync-MFA-secure-users-to-group\_scheduled

### 詳細

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

### アクセス許可

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

* **型**: Microsoft Graph
  * AuditLog.Read.All
    * *userRegistrationDetails を読み取り、各ユーザーの登録済み MFA 方法を評価します*
  * Group.Read.All
    * *ターゲット グループと除外グループ、およびそれらの推移的なユーザー メンバーを読み取ります*
  * GroupMember.ReadWrite.All
    * *バッチ化された /groups/{id}/members/$ref 呼び出しを使用して、ターゲット グループ内でユーザーを追加および削除します*
  * Organization.Read.All
    * */organization を読み取り、レポートの表紙シートとメール内の Tenant 名を取得します*
  * RoleManagement.Read.Directory
    * *ExcludeAdmins が有効な場合に管理者ユーザーを除外するために、ロール割り当てと適格性スケジュールを読み取ります*
  * User.Read.All
    * *管理者ロールのプリンシパルと ExcludeUserIds のエントリをユーザー オブジェクトに解決します*
  * Mail.Send *（任意 — 機能: メール レポート）*
    * *メールによるレポート配信が有効な場合、Send-RjRbReportEmail を使用してレポート メールを送信します*

### パラメーター

#### TargetGroupId

メンバーがこの runbook によって管理されるグループ。もはや適格でないメンバーは削除されます。

| プロパティ    | 値          |
| -------- | ---------- |
| 必須       | true       |
| 既定値      |            |
| 型        | 文字列        |
| ポータルの表示名 | ターゲット グループ |

#### IncludePasskeys

フィッシング耐性のあるパスキーと FIDO2 Security Key は、安全としてカウントされます。

| プロパティ    | 値                                         |
| -------- | ----------------------------------------- |
| 必須       | false                                     |
| 既定値      | True                                      |
| 型        | ブール値                                      |
| ポータルの表示名 | パスキーと FIDO2 Security Key は安全としてカウントされますか？ |

#### IncludePlatformCredentials

Windows Hello for Business と macOS のプラットフォーム資格情報は、安全としてカウントされます。

| プロパティ    | 値                            |
| -------- | ---------------------------- |
| 必須       | false                        |
| 既定値      | True                         |
| 型        | ブール値                         |
| ポータルの表示名 | プラットフォーム資格情報は安全としてカウントされますか？ |

#### IncludeMicrosoftAuthenticator

Microsoft Authenticator アプリは、プッシュまたはパスワードレス サインインのいずれでも、安全としてカウントされます。

| プロパティ    | 値                                        |
| -------- | ---------------------------------------- |
| 必須       | false                                    |
| 既定値      | True                                     |
| 型        | ブール値                                     |
| ポータルの表示名 | Microsoft Authenticator は安全としてカウントされますか？ |

#### IncludeSoftwareOtp

Authenticator アプリからの時間ベースの 1 回限りのコードは、安全としてカウントされます。

| プロパティ    | 値                           |
| -------- | --------------------------- |
| 必須       | false                       |
| 既定値      | False                       |
| 型        | ブール値                        |
| ポータルの表示名 | ソフトウェア OTP は安全としてカウントされますか？ |

#### IncludeHardwareOtp

ハードウェア 1 回限りのパスワード トークンは、安全としてカウントされます。

| プロパティ    | 値                               |
| -------- | ------------------------------- |
| 必須       | false                           |
| 既定値      | False                           |
| 型        | ブール値                            |
| ポータルの表示名 | ハードウェア OTP トークンは安全としてカウントされますか？ |

#### IncludeCertificateBasedAuth

スマート カードなどの証明書を使ったサインインは、安全としてカウントされます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | True                      |
| 型        | ブール値                      |
| ポータルの表示名 | 証明書ベースの認証は安全としてカウントされますか？ |

#### SecureOnly

厳格モード: 電話、メール、またはセキュリティの質問の方法も登録しているユーザーは、安全な方法があっても決して適格になりません。

| プロパティ    | 値      |
| -------- | ------ |
| 必須       | false  |
| 既定値      | False  |
| 型        | ブール値   |
| ポータルの表示名 | 厳格モード？ |

#### SecureMethodsOverride

カンマ区切りで、安全としてカウントされる方法名のカスタム一覧です。設定すると、個々の方法の切り替えは無視されます。runbook customization で事前設定されます。方法名は runbook のドキュメントに記載されています。

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

#### UnsecureMethodsOverride

厳格モードで安全でないと見なされる方法名のカンマ区切りのカスタム一覧です。runbook customization で事前設定されます。

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

#### ExcludeAdmins

アクティブまたは適格な Entra ID ディレクトリ ロールを持つユーザーは決して適格にならず、グループから削除されます。グループがセルフサービス パスワード リセットを制御している場合に便利です。

| プロパティ    | 値           |
| -------- | ----------- |
| 必須       | false       |
| 既定値      | True        |
| 型        | ブール値        |
| ポータルの表示名 | 管理者を除外しますか？ |

#### ExcludeGroupId

たとえばブレークグラスやサービス アカウントなど、このグループのメンバーは決して適格にならず、ターゲット グループから削除されます。何もない場合は空欄のままにしてください。

| プロパティ    | 値      |
| -------- | ------ |
| 必須       | false  |
| 既定値      |        |
| 型        | 文字列    |
| ポータルの表示名 | 除外グループ |

#### ExcludeUserIds

決して適格にならず、ターゲット グループから削除されるユーザーです。複数選択できます。

| プロパティ    | 値         |
| -------- | --------- |
| 必須       | false     |
| 既定値      | @()       |
| 型        | 文字列\[]    |
| ポータルの表示名 | 除外されたユーザー |

#### WhatIfMode

グループを変更せずに、どのユーザーが追加または削除されるかのみを記録します。

| プロパティ    | 値       |
| -------- | ------- |
| 必須       | false   |
| 既定値      | False   |
| 型        | ブール値    |
| ポータルの表示名 | ドライ ラン？ |

#### SendEmail

ポータルの「Report delivery」オプションで設定された、受信者のメール アドレスにレポートを送信します。

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

#### EmailTo

レポートをこれらのアドレスに送信します。複数ある場合はカンマで区切ってください。各受信者には個別のメールが送信されます。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | 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 のカスタマイズで事前設定） |

#### ReportFileFormat

レポートを CSV、Excel ブック、またはその両方で配信します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | CSV と XLSX               |
| 型        | 文字列                      |
| ポータルの表示名 | レポート ファイル形式              |
| ポータルで非表示 | はい（runbook のカスタマイズで事前設定） |

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

| ポータル オプション | 値          |
| ---------- | ---------- |
| CSV と XLSX | CSV と XLSX |
| CSV のみ     | CSV のみ     |
| XLSX のみ    | XLSX のみ    |

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。ポータルの「Report delivery」オプションで設定されます。

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

#### ContainerName

レポート ファイルをアップロードする Storage container。runbook ごとに設定します。

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

#### ResourceGroupName

レポート アップロード用の Storage Account のリソース グループ。テナント設定 RJReport.StorageAccount.ResourceGroup から取得します。

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

#### StorageAccountName

レポート アップロード用の Storage Account。テナント設定 RJReport.StorageAccount.StorageAccountName から取得します。

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

#### SubscriptionId

レポート アップロード用の Storage Account のサブスクリプション ID。テナント設定 RJReport.StorageAccount.SubscriptionId から取得します。空の場合は、管理対象 ID がサインインするサブスクリプションが使用されます。

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

#### LinkExpiryDays

ダウンロード リンクの有効期間（日数）。テナント設定 RJReport.StorageAccount.LinkExpiryDays から取得します。

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | 6                        |
| 型        | Int32                    |
| ポータルで非表示 | はい（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/org/security/sync-mfa-secure-users-to-group_scheduled.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.
