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

ApiAnomalyEvent

ユーザーが API コールを行う方法の異常を追跡します。このオブジェクトは API バージョン 50.0 以降で使用できます。

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

describeSObjects()

特別なアクセスルール

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

サポートされているサブスクライバー

サブスクライバー サポートされているかどうか
Apex トリガー
フロー はい
プロセス
Pub/Sub API はい
ストリーミング API (CometD) はい

イベント配信割り当ての適用

いいえ

項目

項目 詳細
EvaluationTime
double
プロパティ
Nillable
説明
ポリシーの評価にかかった時間 (ミリ秒単位)。
EventDate
dateTime
プロパティ
Nillable
説明
異常が報告された時間。たとえば、「2020-01-20T19:12:26.965Z」などです。最も細かい設定はミリ秒です。
EventIdentifier
string
プロパティ
Nillable
説明
対応するストレージオブジェクトと共有される、イベントの一意の ID。たとえば、0a4779b0-0da1-4619-a373-0a36991dff90 です。この項目は、イベントとそのストレージオブジェクトを相関させるために使用します。
EventUuid
string
プロパティ
Nillable
説明
プラットフォームイベントメッセージを識別するユニバーサル一意識別子 (UUID)。この項目は、API バージョン 52.0 以降で使用できます。
LoginKey
string
プロパティ
Nillable
説明
特定のユーザーのログインセッションのすべてのイベントを結び付ける文字列。このセッションはログインイベントで開始され、ログアウトイベントまたはユーザーセッションの期限切れで終了します。たとえば、lUqjLPQTWRdvRG4 です。
Operation
string
プロパティ
Nillable
説明
イベントを生成した API コール。たとえば、Query です。
PolicyId
reference
プロパティ
Nillable
説明
このイベントに関連付けられたトランザクションポリシーの ID。たとえば、0NIB000000000KOOAY です。
PolicyOutcome
picklist
プロパティ
Nillable、Restricted picklist
説明
トランザクションポリシーの結果。可能な値には次のものがあります。
  • Error — ポリシーの実行時にポリシーによって未定義のエラーが発生しました。
  • ExemptNoAction — このユーザーはトランザクションセキュリティポリシーの対象外のため、ポリシーがトリガーされませんでした。
  • MeteringBlock — ポリシーの処理に 3 秒以上かかったため、操作を実行できないようにユーザーがブロックされました。
  • MeteringNoAction — ポリシーの処理に 3 秒以上かかりましたが、ユーザーは操作の実行をブロックされませんでした。
  • NoAction — ポリシーがトリガーしませんでした。
  • Notified — 受信者に通知が送信されました。
QueriedEntities
string
プロパティ
Nillable
説明
イベントに関連付けられたエンティティの種別。
ReplayId
string
プロパティ
Nillable
説明
システムによって生成された ID 値を表し、イベントストリーム内のイベントの位置を参照します。連続するイベントに対して再生 ID の値に連番が振られるという保証はありません。サブスクライバーは再生 ID の値を保存し、再登録時にその値を使用して、保持ウィンドウ内の欠落したイベントを取得できます。
RequestIdentifier
string
プロパティ
Nillable
説明
単一トランザクションの一意の ID。トランザクションには、1 つ以上のイベントを含めることができます。特定のトランザクションの各イベントに同じ REQUEST_ID が設定されます。たとえば、3nWgxWbDKWWDIk0FKfF5D です。
RowsProcessed
double
プロパティ
Nillable
説明
現在の操作の合計行数。たとえば、2500 です。
Score
double
プロパティ
Nillable
説明
このイベントで追跡された API の実行またはエクスポートの異常スコアを表す 0 ~ 100 の数値。異常スコアは、ユーザーの現在の API 活動がそのユーザーの通常の活動とどの程度異なるかを示します。低スコアは、ユーザーの現在の API 活動がそのユーザーの通常の活動と類似していることを示しています。高スコアは、それが異なることを示しています。
SecurityEventData
textarea
プロパティ
Nillable
説明
この異常イベントをトリガーした API 活動に関する機能のセット。可能な機能の一覧については、脅威の検出に関するドキュメントを参照してください。

たとえば、通常 10 件の取引先をダウンロードしているユーザーが、そのパターンから逸脱して 1,000 件の取引先をダウンロードしたとします。このイベントがトリガーされ、寄与した機能がこの項目で捕捉されます。可能性のある機能として、行数、列数、平均行サイズ、曜日、レポート活動で使用されたブラウザーのユーザーエージェントなどがあります。この項目で捕捉されるデータでは、この異常イベントのトリガーに特定の機能がどの程度寄与したかもパーセントとして表されます。データは JSON 形式です。

次の例は、異常のトリガーに平均行数が 95% 以上寄与したことを示しています。他の異常機能 (自律システム、レポートが実行された曜日、使用されたブラウザー、列数など) の寄与度はこれより低くなっています。
1[
2{
3"featureName": "rowCount",
4"featureValue": "1937568",
5"featureContribution": “95.00 %"
6},
7{
8"featureName": "autonomousSystem",
9"featureValue": "Bigleaf Networks, Inc.",
10"featureContribution": “1.62 %"
11},
12{
13"featureName": "dayOfWeek",
14"featureValue": "Sunday",
15"featureContribution": “1.42 %"
16},
17{
18"featureName": "userAgent",
19"featureValue": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/76.0.3809.132 Safari/537.36}",
20"featureContribution": “1.21 %"
21},
22{
23"featureName": "periodOfDay",
24"featureValue": “Evening”,
25"featureContribution": “.09 %"
26},
27{
28"featureName": "averageRowSize",
29"featureValue": "744",
30"featureContribution": “0.08 %"
31},
32{
33"featureName": "screenResolution",
34"featureValue": "900x1440",
35"featureContribution": “0.07 %"
36}
37]
SessionKey
string
プロパティ
Nillable
説明
ユーザーの一意のセッション ID。この値を使用して、セッション内のすべてのユーザーイベントを識別します。ユーザーがログアウトしてから再びログインすると、新しいセッションが開始されます。たとえば、vMASKIU6AxEr+Op5 です。
SourceIp
string
プロパティ
Nillable
説明
ログインしているクライアントの供給元 IP アドレス。たとえば、126.7.4.2 など。
Summary
textarea
プロパティ
Nillable
説明
このイベントが作成される原因となった API 異常の概要テキスト。
  • API was exported from an infrequent network (BigLeaf Networks Inc.)
  • API was generated with an unusually high number of rows (111141)
Uri
string
プロパティ
Nillable
説明
要求を受信しているページの URI。
UserAgent
string
プロパティ
Nillable
説明
HTTP 要求で使用され、サーバーで後処理された UserAgent。
UserId
reference
プロパティ
Nillable
説明
発生元ユーザーの一意の ID。たとえば、005000000000123 です。
Username
string
プロパティ
Nillable
説明
イベントが作成された時点での user@company.com 形式の発生元のユーザー名。