この記事は自動的に翻訳されています。翻訳には不正確な表現が含まれる場合があります。
英語の原文はこちらをご覧ください。
Ctrlk
linkedinx-twitter
For the complete documentation index, see llms.txt. This page is also available as Markdown.

MFA 方法を一覧表示

ユーザーのすべての MFA / 認証方法を一覧表示

説明

対象ユーザーに登録されているすべての Microsoft Entra ID 認証方法を取得して表示します。電話ベースの方法については電話番号も含まれます。電話番号はオプションでマスクでき、末尾 4 桁のみを表示します。必要に応じて、MFA メソッドがこの runbook によって取得されたことを通知するメールをユーザーに送信できます。

ユーザー通知を有効にする

この runbook は、MFA メソッドが管理者によって取得されたことを通知するメールを対象ユーザーにオプションで送信できます。これを有効にするには、runbook のカスタマイズでユーザー通知を有効にする必要があります。

この json 設定は次のとおりです:

"rjgit-user_security_list-mfa-methods": {
    "parameters": {
        "UserName": {
            "Hide": true
        },
        "NotifyUser": {
            "Default": true,
            "Hide": true
        },
        "MaskPhoneNumbers": {
            "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 テナント設定から取得されます。

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

以下を参照してください RealmJoin レポート設定ドキュメント 利用可能なすべての設定の詳細について。

メールのブランド設定

レポートメールは、任意の RJReport.Branding.* テナント設定に従います:

  • ヘッダーおよびフッター画像 – 公開 HTTPS URL、PNG/JPEG/GIF、各最大 200 KB

  • フッターリンク – フッター画像のリンク先

  • アクセント色とテキスト色 – 6 桁の 16 進数値、例: #0052cc

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

セットアップ手順と画像要件: メールのブランド設定.

場所

ユーザー → セキュリティ → MFA メソッドの一覧

完全な runbook 名

rjgit-user_security_list-MFA-methods

詳細

プロパティ
値

バージョン

1.2.0

必要なモジュール

RealmJoin.RunbookHelper (>= 0.8.9) Microsoft.Graph.Authentication (>= 2.39.0)

スケジュール可能

いいえ

注記

権限（マネージド ID、アプリケーション）:

  • UserAuthenticationMethod.Read.All - 認証方法の一覧を取得

  • User.Read.All - 対象ユーザーを解決

  • Organization.Read.All - メール本文用にテナントの表示名を読み取る

  • Mail.Send - NotifyUser が有効な場合にのみ必要です

プライバシー / 監査:

  • この runbook は、機密性の高い ID データ（登録済みの MFA メソッド、電話番号を含む）を読み取ります。電話番号は既定でマスクされます。正当なサポート目的で完全な番号が必要な場合にのみ、MaskPhoneNumbers を false に設定してください。操作は CallerName とともにログに記録されます。

  • NotifyUser が有効な場合、管理者が MFA メソッドを取得したことがメールで対象ユーザーに通知されます。これには、テナント設定 RJReport.EmailSender の構成が必要です。

アクセス許可

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

  • 種類: Microsoft Graph

    • Mail.Send (オプション — 機能: メール レポート)

      • 通知が有効な場合、Send-RjReportEmail を使用して MFA 参照通知メールをユーザーのメールボックスに送信します

    • Organization.Read.All

      • 通知メールにテナント名を入れるために /organization を読み取ります

    • User.Read.All

      • id、mail、accountEnabled、usageLocation を取得するために対象ユーザーを解決します

    • UserAuthenticationMethod.Read.All

      • 電話番号と FIDO2 の詳細を含む、ユーザーの登録済み MFA メソッドを一覧表示します

パラメーター

UserName

対象ユーザーのユーザー プリンシパル名。ユーザー コンテキストで RealmJoin ポータルによって自動入力されます。

プロパティ
値

必須

はい

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

NotifyUser

有効にすると、管理者が MFA メソッドを取得したことを通知するメールを対象ユーザーに送信します。既定では無効です。

プロパティ
値

必須

いいえ

既定値

False

種類

ブール値

ポータル表示名

メールでユーザーに通知する

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

MaskPhoneNumbers

有効にすると、すべての電話番号が末尾 4 桁を除いてマスクされます（例: +491234567890 は ********7890 になります）。既定では無効です。

プロパティ
値

必須

いいえ

既定値

False

種類

ブール値

ポータル表示名

電話番号をマスクする（下4桁のみ表示）

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

EmailFrom

任意の通知メールの送信元メール アドレス。RealmJoin Tenant 設定 RJReport.EmailSender から取得されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingHeaderImageUrl

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

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingFooterImageUrl

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

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingFooterLink

フッター画像がリンクする任意の URL。RJReport.Branding.FooterLink テナント設定から取得されます。空の場合は既定のリンク（https://www.realmjoin.com）が使用されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingAccentColor

レポートメール テンプレート用の任意のアクセント色の上書き（6 桁の 16 進数、例: '#0052cc'）。RJReport.Branding.AccentColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin アクセント色が使用されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

BrandingTextColor

レポートメール テンプレート用の任意のテキスト色の上書き（6 桁の 16 進数）。RJReport.Branding.TextColor テナント設定から取得されます。空または無効な場合は、既定の RealmJoin テキスト色が使用されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ServiceDeskDisplayName

ユーザー連絡先情報用の Service Desk 表示名（任意）。RealmJoin Tenant 設定 RJReport.ServiceDesk_DisplayName から取得されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ServiceDeskEmail

ユーザー連絡先情報用の Service Desk メール アドレス（任意）。RealmJoin Tenant 設定 RJReport.ServiceDesk_EMail から取得されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ServiceDeskPhone

ユーザー連絡先情報用の Service Desk 電話番号（任意）。RealmJoin Tenant 設定 RJReport.ServiceDesk_Phone から取得されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ServiceDeskPortalUrl

ユーザー連絡先情報用の Service Desk ポータル URL。クリック可能なリンクとして表示されます（任意）。RealmJoin Tenant 設定 RJReport.ServiceDesk_PortalUrl から取得されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

ServiceDeskTicketUrl

この要求に関連する Service Desk チケットへの直接リンク。クリック可能なリンクとして表示されます（任意）。既定では空のため、チケット リンクは追加されません。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

LanguageOverride

通知メールで使用する言語を上書きします。使用可能な値は 'DE'（ドイツ語）または 'EN'（英語）です。空白のままにすると、対象ユーザーの使用場所に基づいて言語が自動的に決定されます。

プロパティ
値

必須

いいえ

既定値

種類

文字列

ポータルでは非表示

はい（runbook のカスタマイズで事前設定）

Runbook Reference の概要に戻る

最終更新

役に立ちましたか？