> 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/list-signin-events.md).

# サインイン イベントを一覧表示

このユーザーの最近のサインインとその失敗を表示

### 説明

選択した日数分のこのユーザーの Entra ID サインインを、アプリケーション、時刻、結果、クライアント アプリ、デバイス、場所とともに一覧表示します。失敗はアプリケーションごとに集計されるため、サポートはサインインのどこで問題が発生しているかを把握でき、失敗したサインインには IP アドレスも表示されます。レポートはメールで送信することも、ダウンロードリンクとして提供することもできます。

### 一般的な使用例

* 特定のユーザーでどのアプリケーションがサインイン失敗を引き起こしているのか、その理由をエラー コードごとにグループ化して調査します。
* 結果を次で絞り込みます `アプリケーション名` (部分一致) または `FailedSignInsOnly` ユーザーがアクセスの問題を報告したとき。
* イベント数が多すぎてポータルで読み取れない場合は、サインイン データを CSV または Excel にエクスポートして、さらに分析します。

### 動作

* サインイン ログ データは Microsoft Graph のベータ エンドポイントから取得されます。これは、サインイン イベント タイプのフィルタリングと非対話型サインインの取得に、ベータ版でのみ使用できるプロパティ（`signInEventTypes`, `authenticationRequirement`).
* 結果は次に書き込まれます **出力データ** 各実行ごとにジョブのタブに書き込まれます: サマリー、アプリケーション別サマリー、失敗したサインイン、および、失敗したサインインのみが要求されていない場合はすべてのサインイン。コンソールには件数が表示されます。
* 非対話型サインインは対話型サインインを大きく上回ります。Output Data タブのサインイン テーブルは最新 250 件に制限されていますが、エクスポートされたレポート ファイルには常に完全な結果セットが含まれます。

### 必要なライセンスと権限

Microsoft Graph API を通じてサインイン ログを読み取るには、 **Entra ID P1 または P2 ライセンス** テナント内で必要です。これがないテナントは、すべての Graph 権限が付与されていても、サインイン ログ クエリから 403 エラーを受け取ります。P1/P2 では、サインイン ログは最大 30 日間保持されます。無料版の 7 日間保持は Entra ポータルに適用され、この runbook には適用されません。

サインイン ログ クエリが 403 を返す場合、 `AuditLog.Read.All` が付与され、テナントにライセンスがあるにもかかわらず、一部のテナントではさらに `Directory.Read.All` Entra レポート API への権限が必要です。これを付与することが既知の回避策です。既定では宣言されません。これはすべてのディレクトリ オブジェクトへの読み取りアクセスを付与するためです。

### レポート配信

レポートファイルは、配信方法が次の方法で選択された場合にのみ生成されます。 **レポート配信** オプション（メールおよび/またはダウンロードリンク）。 *Output Data のみ* 選択されている場合、レポート ファイルは作成されず、サインイン分析は RealmJoin ポータル内のジョブの Output Data タブで読み取られます。メール配信とダウンロードリンクの生成は独立しており、組み合わせることができます。

ダウンロードリンクの場合、レポートファイルは、 `RJReport.StorageAccount.*` テナント設定で構成された Azure Storage Account にアップロードされ、時間制限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは Automation アカウントのマネージド ID で認証します。その ID には、 **Reader and Data Access** RBAC ロールがターゲットの Storage Account に必要です（これは Azure RBAC の割り当てであり、Graph アプリケーション権限ではありません）。

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

メールレポートの送信は任意であり、次の場合にのみ行われます。 *レポートもメール送信* または *メール送信とダウンロードリンクも追加* レポート配信として選択されると、受信者が必要になります。送信者アドレスは `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).

### 結果の解釈

Entra では、一部のサインイン中断をエラーとしてカウントします（たとえば 50140 "Keep me signed in"、50058、50076）。そのため、それらは失敗として表示され、アプリケーションごとの失敗率に含まれます。高い失敗率を本当の問題として扱う前に、失敗理由を確認してください。エラー コードは Entra ID のサインイン エラー コードです。次で確認してください <https://login.microsoftonline.com/error>.

サインイン ログ データは通常約 15 分遅延しますが、一部のレコードでは最大 2 時間かかる場合があります。ごく最近のサインインはまだ表示されていない可能性があります。すべてのタイムスタンプは UTC で表示されます。

### 場所

ユーザー → セキュリティ → サインイン イベント一覧

**完全な Runbook 名**

rjgit-user\_security\_list-signin-events

### 詳細

| プロパティ    | 値                                                                                                                  |
| -------- | ------------------------------------------------------------------------------------------------------------------ |
| バージョン    | 1.1.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
    * *レポートを作成するために、対象ユーザーの Entra ID サインイン イベントを auditLogs/signIns (beta) から読み取ります*
  * User.Read.All
    * *対象ユーザーを解決して、id、userPrincipalName、displayName を取得します*
  * Mail.Send *(オプション — 機能: メール レポート)*
    * *メール配信が選択されている場合、Send-RjRbReportEmail を介して CSV/XLSX 添付ファイル付きのサインイン レポート メールを送信します*
  * Organization.Read.All *(オプション — 機能: メール レポート)*
    * */organization を読み取り、レポート メールのフッターにテナント名を入れます*

#### アクセス許可に関する注意

Azure Storage Account: Automation Account のマネージド ID に対してターゲットの Storage Account 上で 'Reader and Data Access' ロールを付与します。アップロードでは listKeys を使用してアカウント キーを取得します（ダウンロードリンクのオプションでのみ必要です）

### パラメーター

#### UserName

Runbook が対象とするユーザーのユーザー プリンシパル名。ポータルで選択されたユーザーから設定されます。

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

#### 日数

含めるサインイン ログの日数。1 〜 30 日。

| プロパティ   | 値     |
| ------- | ----- |
| 必須      | false |
| 既定値     | 7     |
| 種類      | Int32 |
| ポータル表示名 | 遡る日数  |

#### SignInType

ユーザーによる対話型サインイン、アプリとトークンによる非対話型サインイン、またはその両方。

| プロパティ   | 値        |
| ------- | -------- |
| 必須      | false    |
| 既定値     | 対話型のみ    |
| 種類      | 文字列      |
| ポータル表示名 | サインインの種類 |

#### FailedSignInsOnly

成功したサインインを非表示にして、失敗とその理由を目立たせます。

| プロパティ   | 値            |
| ------- | ------------ |
| 必須      | false        |
| 既定値     | False        |
| 種類      | ブール値         |
| ポータル表示名 | 失敗したサインインのみ？ |

#### アプリケーション名

名前にこのテキストを含むアプリケーションへのサインインのみを表示します。すべてのアプリケーションを対象にするには空欄のままにします。

| プロパティ   | 値              |
| ------- | -------------- |
| 必須      | false          |
| 既定値     |                |
| 種類      | 文字列            |
| ポータル表示名 | アプリケーション フィルター |

#### 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 のカスタマイズで事前設定) |

#### SendEmailReport

レポートをメールで送信するかどうか。runbook のカスタマイズで事前設定されます。

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

#### EmailTo

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

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

#### ReportFileFormat

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

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

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

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

#### CreateDownloadLink

レポートもアップロードし、数日後に期限切れになるダウンロード リンクを返します。

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

#### コンテナー名

レポート ファイルがアップロードされるストレージ コンテナーです。runbook ごとに設定します。

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

#### リソース グループ名

レポート アップロード用のストレージ アカウントのリソース グループです。Tenant 設定 RJReport.StorageAccount.ResourceGroup から取得されます。

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

#### Storage Account 名

レポート アップロード用の Storage Account です。Tenant 設定 RJReport.StorageAccount.StorageAccountName から取得されます。

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

#### LinkExpiryDays

ダウンロード リンクが有効なままの期間（日数）です。Tenant 設定 RJReport.StorageAccount.LinkExpiryDays から取得されます。

| プロパティ    | 値                         |
| -------- | ------------------------- |
| 必須       | false                     |
| 既定値      | 6                         |
| 種類       | Int32                     |
| ポータルで非表示 | はい (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/list-signin-events.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.