この文章は 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 句が含まれないため、特殊なルールは適用されません。
  • EventDate で絞り込み
    • 有効 — EventDate のみで絞り込みできますが、他の項目で絞り込むと失敗します。このクエリ種別では比較演算子も使用できます。
    • 有効 — 日付リテラルを使用して EventDate で絞り込みができます。
  • EventDate および EventIdentifier で絞り込み
    • 有効 — 両方の項目に対する LogoutEvent 条件のクエリは正常に実行できます。
    • 無効 — EventDate と標準日付リテラルを使用した LogoutEvent ��対するクエリ。
    • 無効 — <= または >= を使用する EventDate と EventIdentifier 項目のみでの絞り込みはサポートされていません。

非同期 SOQL 使用状況

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

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

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