この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

LogoutEvent

��ーザーの UI からのログアウトを追跡します。ログアウトイベントには、成功した、組織の UI からのユーザーログアウトが記録されます。LogoutEvent は、LogoutEventStream のイベントデータを格納する Big Object です。このオブジェクトは API バージョン 46.0 以降で使用できます。

LogoutEvent データは、ログアウト時にカスタムロジックを実装するために使用します。たとえば、ログアウト時にユーザーのすべての更新トークンを呼び出すことができます。

LogoutEvent はタイムアウトではなくログアウトを記録します。タイムアウトの場合は LogoutEventStream オブジェクトが公開されません。例外は、組織で [セッションタイムアウト時に強制的にログアウト] 設定が有効になっているために、ユーザーのセッションがタイムアウトになった後にユーザーが自動的に組織からログアウトされた場合です。この場合はログアウトイベントが記録されます。ただし、ユーザーがセッション中にブラウザーを閉じた場合は、[セッションタイムアウト時に強制的にログアウト] 設定が有効になっているかどうかに関係なく、ログアウトイベントは記録されません。

メモ

サポートされているコール

describeSObjects()、query()

特別なアクセスルール

このオブジェクトにアクセスするには、Salesforce Shield または Salesforce Event Monitoring アドオンサブスクリプションと、「リアルタイムイベント監視データを表示」ユーザー権限が必要です。

項目

項目名	詳細
EventDate	型 dateTime プロパティ Filter、Sort 説明指定されたログアウトイベントが捕捉された時間。たとえば、「`2020-01-20T19:12:26.965Z`」などです。最も細かい設定はミリ秒です。
EventIdentifier	型 string プロパティ Filter、Sort 説明イベントの一意の ID。たとえば、`0a4779b0-0da1-4619-a373-0a36991dff90` です。
LoginKey	型 string プロパティ Nillable 説明特定のユーザーのログインセッションのすべてのイベントを結び付ける文字列。ログインイベントから開始され、ログアウトイベントまたはユーザーセッションの期限切れで終了します。
SessionKey	型 string プロパティ Nillable 説明ユーザーの一意のセッション ID。この値を使用して、セッション内のすべてのユーザーイベントを識別できます。ユーザーがログアウトしてから再びログインすると、新しいセッションが開始されます。
SessionLevel	型 picklist プロパティ Nillable、Restricted picklist 説明このイベントでユーザーがログアウトするセッションのセッションレベルセキュリティを示します。セッションレベルのセキュリティは、接続アプリケーションやレポートなど、このセキュリティをサポートする機能へのユーザーのアクセス権を制御します。可能な値は次のとおりです。 `HIGH_ASSURANCE` — リソースへのアクセスに高保証セッションが使用されました。たとえば、高保証セッションレベルが必要な接続アプリケーション、レポート、ダッシュボードなどのリソースにユーザーがアクセスしようとした場合です。 `LOW` — 現在のセッションに対するユーザーのセキュリティレベルが最低限の要件を満たします。この Low レベルは、Salesforce UI で利用不可能であり、使用されません。UI を介したユーザーセッションは、標準または高保証です。このレベルは API を使用して設定できますが、このレベルに割り当てられたユーザーは、Salesforce 組織で使用できる機能が制限され、またどの機能を使用できるかを判断することができません。メモ `STANDARD` — 現在のセッションに対するユーザーのセキュリティレベルが、現在の組織のセッションセキュリティレベルの標準の要件セットを満たします。
SourceIp	型 string プロパティ Nillable 説明ログアウトするクライアントの供給元 IP アドレス。たとえば、`126.7.4.2` です。
UserId	型 reference プロパティ Nillable 説明ログアウトイベントに関連付けられたユーザーの ID を表します。
Username	型 string プロパティ Nillable 説明ログアウトイベントに関連付けられたユーザーのユーザー名を表します。

標準 SOQL 使用状況

現在、LogoutEvent でサポートされる SOQL 関数は WHERE のみで、比較演算子 (=、<、>、<=、>=) は WHERE 句の最後の式でのみ使用できます。!= 演算子はサポートされていません。

convertTimezone() などの日付関数はサポートされていません。たとえば、SELECT CALENDAR_YEAR(EventDate), Count(EventIdentifier) FROM LogoutEvent GROUP BY CALENDAR_YEAR(EventDate) はエラーを返します。クエリの日付リテラルや、TODAY、YESTERDAY、LAST_n_DAYS:1 のような日付および日付/時間関数は使用できます。ただし、これらの関数はバックグラウンドで比較演算子を使用します。つまり、これらは WHERE 句の最後の式でのみ使用できます。

メモ

LogoutEvent では、2 つの順序付けられた項目 (EventDate と EventIdentifier) で絞り込みができます。ただし注意すべき点があります。これらの項目を正しい順序に並べ、組み合わせて使用しないとクエリは機能しません。次のリストで、有効なクエリと無効なクエリの例を確認してください。

絞り込みなし
- 有効 — WHERE 句が含まれないため、特殊なルールは適用されません。
  1SELECT EventDate, EventIdentifier, SourceIp, UserId 2FROM LogoutEvent
EventDate で絞り込み
- 有効 — EventDate のみで絞り込みできますが、他の項目で絞り込むと失敗します。このクエリ種別では比較演算子も使用できます。
  1SELECT EventDate, EventIdentifier, SourceIp, UserId 2FROM LogoutEvent 3WHERE EventDate<=2014-11-27T14:54:16.000Z
- 有効 — 日付リテラルを使用して EventDate で絞り込みができます。
  1SELECT EventDate, EventIdentifier, SourceIp, UserId 2FROM LogoutEvent 3WHERE EventDate<=TODAY

EventDate および EventIdentifier で絞り込み

有効 — 両方の項目に対する LogoutEvent 条件のクエリは正常に実行できます。

1SELECT EventDate, EventIdentifier, SourceIp, UserId
2FROM LogoutEvent
3WHERE EventDate=2014-11-27T14:54:16.000Z and EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

無効 — EventDate と標準日付リテラルを使用した LogoutEvent に対するクエリ。

1SELECT EventDate, EventIdentifier, SourceIp, UserId
2FROM LogoutEvent
3WHERE EventDate=TODAY and EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

無効 — <= または >= を使用する EventDate と EventIdentifier 項目のみでの絞り込みはサポートされていません。

1SELECT EventDate, EventIdentifier, SourceIp, UserId
2FROM LogoutEvent
3WHERE EventDate<=2014-11-27T14:54:16.000Z and EventIdentifier='f0b28782-1ec2-424c-8d37-8f783e0a3754'

非同期 SOQL 使用状況

非同期 SOQL の場合は、LogoutEvent の項目を絞り込み、クエリに任意の比較演算子を使用できます。

例: 昨日の成功したログアウトの取得

SELECT EventDate, EventIdentifier, SourceIp, UserId FROM LogoutEvent WHERE EventDate<Yesterday

プラットフォームイベント開発者ガイド

LogoutEvent

サポートされているコール

特別なアクセスルール

項目

標準 SOQL 使用状況

非同期 SOQL 使用状況

関連項目: