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

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

説明

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

ユーザー通知を有効化

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

この 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 カスタマイズ ガイド.

メール送信に関する設定

通知メールの送信は任意であり、次の場合にのみ行われます NotifyUser が有効になっている場合です。送信者アドレスは次から取得されます RJReport.EmailSender Tenant 設定から取得されます。

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

詳細については RealmJoin Report Settings のドキュメント を参照してください。

メールのブランド設定

レポート メールでは、任意の RJReport.Branding.* Tenant 設定が使用されます:

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

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

設定手順と画像要件: メールのブランド設定.

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
必要なモジュール	RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)
スケジュール可能	いいえ

権限

アプリケーションの権限

• 種類: 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

E.164 形式の番号。たとえば [phone]。

プロパティ	値
必須	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)。Tenant 設定 RJReport.Branding.HeaderImageUrl から取得されます。空欄の場合は既定の RealmJoin ヘッダーが使用されます。

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

BrandingFooterImageUrl

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

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

BrandingFooterLink

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

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

BrandingAccentColor

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

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

BrandingTextColor

レポート メールのテキスト カラー。6 桁の 16 進値で指定します。Tenant 設定 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 リファレンスの概要に戻る