> 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 アドレスも表示されます。レポートはメールで送信するか、ダウンロード リンクとして提供できます。

### 一般的な使用例

* 特定のユーザーについて、どのアプリケーションがサインイン失敗を発生させているのか、またその理由をエラー コード別にグループ化して調査します。
* 以下を使用して結果を絞り込みます `ApplicationName` （部分一致）または `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 で必要になります。これを付与することが既知の回避策です。すべてのディレクトリ オブジェクトへの読み取りアクセスを許可するため、既定では宣言されていません。

### レポートの配信

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

ダウンロードリンクの場合、レポート ファイルは、Azure Storage Account に構成された `RJReport.StorageAccount.*` テナント設定にアップロードされ、期限付きの SAS ダウンロードリンクが返されます。ストレージへのアップロードは、Automation アカウントのマネージド ID で認証されます。その ID には **Reader and Data Access** 対象の Storage Account に対する RBAC ロールが必要です（これは 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「サインインしたままにする」、50058、50076）、それらは失敗として表示され、アプリケーションごとの失敗率に含まれます。高い失敗率を実際の問題とみなす前に、失敗の理由を確認してください。エラー コードは Entra ID のサインイン エラー コードです。詳細は <https://login.microsoftonline.com/error>.

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

### 場所

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

**完全な Runbook 名**

rjgit-user\_security\_list-signin-events

### 詳細

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

#### 権限に関する注意事項

Azure Storage Account: 対象 Storage Account 上の Automation アカウントのマネージド ID に対する 'Reader and Data Access' ロール - アップロードでは listKeys 経由でアカウント キーを取得します（ダウンロードリンク オプションでのみ必要です）

### パラメーター

#### ユーザー名

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

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

#### 日数

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

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

#### SignInType

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

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

#### FailedSignInsOnly

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

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

#### ApplicationName

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

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

#### ContainerName

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

| プロパティ    | 値                        |
| -------- | ------------------------ |
| 必須       | false                    |
| 既定値      | user-signin-events       |
| 型        | 文字列                      |
| ポータルで非表示 | はい（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/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.
