LoginAnomalyEvent

This entity detects data access anomalies that are caused by potentially malicious login actions. This object is available in API version 64.0 and later.

Supported Calls

describeSObjects()

Special Access Rules

Accessing this object requires either the Salesforce Shield or Event Monitoring add-on subscription and the View Real-Time Event Monitoring Data user permission.

The Machine Learning (ML) models that power Threat Detection analyze data to ensure accurate identification, which requires a brief processing time. This results in an expected time difference between the Event Detection Date and the Event Creation Date.

Note

Supported Subscribers

Subscriber	Supported?
Apex Triggers
Flows
Processes
Pub/Sub API
Streaming API (CometD)

Event Delivery Allocation Enforced

Fields

EvaluationTime

Type: double

Properties: Nillable

Description: A date value that represents aggregated timeframe of when Login Anomaly Actions occured

EventDate

Type: dateTime

Properties: Nillable

Description: A date value (no time portion) that represents aggregate timeframe when the login anomaly actions occurred.

EventIdentifier

Type: string

Properties: Nillable

Description: The unique ID of the event, which is shared with the corresponding storage object

EventUuid

Type: string

Properties: Nillable

Description: A universally unique identifier (UUID) that identifies a platform event message.

FeatureContribution

Type: double

Properties: Filter, Nillable, Sort

Description: The feature’s contribution towards triggering an anomaly event.

FeatureName

Type: string

Properties: Filter, Group, Nillable, Sort

Description: The feature’s name.

FeatureValue

Type: double

Properties: Filter, Nillable, Sort

Description: The feature’s value.

LoginKey

Type: string

Properties: Nillable

Description: The string that ties together all events in a given user’s login session.

PolicyId

Type: reference

Properties: Nillable

Description: The ID of the transaction policy associated with this event. This field isn’t populated until all transaction security policies are processed for the real-time event.

PolicyOutcome

Type: picklist

Properties: Nillable, Restricted picklist

Description: The result of the transaction policy.

ReplayId

Type: string

Properties: Nillable

Description: Represents an ID value that is populated by the system and refers to the position of the event in the event stream. Replay ID values aren’t guaranteed to be contiguous for consecutive events. A subscriber can store a replay ID value and use it on resubscription to retrieve missed events that are within the retention window.

Score

Type: double

Properties: Nillable

Description: A number from 0 through 1 that represents the anomaly score for the report execution or export tracked by this event. The anomaly score shows how the user’s current report activity is different from their typical activity. A low score indicates that the user’s current report activity is similar to their usual activity, a high score indicates that it’s different.

SecurityEventData

Type: textarea

Properties: Nillable

Description: The set of features about the report activity that triggered this anomaly event.

SessionKey

Type: string

Properties: Nillable

Description: The user’s unique session ID. Use this value to identify all user events within a session.

SourceIp

Type: string

Properties: Nillable

Description: The source IP address of the client that logged in

Summary

Type: textarea

Properties: Nillable

Description: A text summary of the threat that caused this event to be created. The summary lists the browser fingerprint features that most contributed to the threat detection along with their contribution to the total score.

UserId

Type: reference

Properties: Nillable

Description: The origin user’s unique ID. For example, 005000000000123.

Username

Type: string

Properties: Nillable

Description: The origin username in the format of user@company.com at the time the event was created.