Newer Version Available

This content describes an older version of this product. View Latest

AdminSetupEvent (Beta)

Tracks user operations for managing encryption keys in your org. AdminSetupEvent is evaluated in a transaction security policy. AdminSetupEvent is a big object that stores the event data of AdminSetupEventStream. This object is available in API version 42.0 and later.

This object is included in Real-Time Event Monitoring (Beta). As a beta feature, Real-Time Event Monitoring is a preview and isn’t part of the “Services” under your master subscription agreement with Salesforce. Use this feature at your sole discretion, and make your purchase decisions only on the basis of generally available products and features. Salesforce doesn’t guarantee general availability of this feature within any particular time frame or at all, and we can discontinue it at any time. This feature is for evaluation purposes only, not for production use. It’s offered as is and isn’t supported, and Salesforce has no liability for any harm or damage arising out of or in connection with it. All restrictions, Salesforce reservation of rights, obligations concerning the Services, and terms for related Non-Salesforce Applications and Content apply equally to your use of this feature. You can provide feedback and suggestions for this object in the Real-Time Event Monitoring Beta group in the Trailblazer Community.

Note

Supported Calls

describeSObjects(), query()

Special Access Rules

Accessing this object requires the Shield Event Monitoring add-on, and the View Data Leakage Detection Events and API Enabled user permissions. This object contains data if a user with Manage Encryption Keys permission creates, reads, updates, or deletes a TenantSecret object in the API or accesses the following Setup pages in the UI:
  • Key Management
  • Encryption Policy
  • Bring Your Own Keys
  • Certificates
It doesn’t contain data when a user issues a describe() call in the API. Bulk calls and Apex are supported.

Fields

Field Details
EvaluationTime
Type
double
Properties
Nillable
Description
The amount of time it took to evaluate the policy in milliseconds.
EventDate
Type
dateTime
Properties
Filter, Sort
Description
The time when the specified API event was captured (after query execution takes place). For example, 2013-01-01T03:01:01Z. Seconds are the most granular setting.
EventIdentifier
Type
string
Properties
Filter, Sort
Description
The unique ID of the event. For example, 4DWDVuDbwCDZcEIdp7MQZ.
LoginKey
Type
string
Properties
Nillable
Description
The string that ties together all events in a given user’s login session. The session starts with a login event and ends with either a logout event or the user session expiring.
Operation
Type
string
Properties
Nillable
Description
The API call that generated the event (query(), queryAll() , queryMore(), delete(), update(), upsert()). If it’s a UI operation, the value corresponds to the client method that occurred on the URI.
PolicyId
Type
reference
Properties
Nillable
Description
The ID of the transaction policy associated with this event.
PolicyOutcome
Type
picklist
Properties
Nillable, Restricted picklist
Description
The result of the transaction policy. Possible values are:
  • Block - The user was blocked from performing the operation that triggered the policy.
  • EndSession - The Concurrent Sessions Limiting policy activated, limiting the number of concurrent sessions per user.
  • Error - The policy caused an undefined error when it executed.
  • FailedInvalidPassword - The user entered an invalid password.
  • FailedPasswordLockout - The user entered an invalid password too many times.
  • NoAction - The policy didn't trigger.
  • Notified - A notification was sent to the recipient.
RelatedEventIdentifier
Type
string
Properties
Nillable
Description
Represents the EventIdentifier of the related event. This field is available in API version 43.0 and later.
Resource
Type
string
Properties
Nillable
Description
Indicates the logical resource that triggered the event. It could be an entity name (if an API operation) or a URI (if a UI operation).
SessionKey
Type
string
Properties
Nillable
Description
The user’s unique session ID. Use this value to identify all user events within a session. When a user logs out and logs in again, a new session is started.
SessionLevel
Type
picklist
Properties
Nillable
Description
Indicates the session-level security of the session that the user is logging out of for this event. Session-level security controls user access to features that support it, such as connected apps and reporting. Possible values are:
  • LOW - The user’s security level for the current session meets the lowest requirements.

    This low level is not available, nor used, in the Salesforce UI. User sessions through the UI are either standard or high assurance. You can set this level using the API, but users assigned this level will experience unpredictable and reduced functionality in their Salesforce org.

    Note

  • STANDARD - The user’s security level for the current session meets the Standard requirements set in the current organization Session Security Levels.
  • HIGH_ASSURANCE - A high assurance session was used for the current session. For example, when the user tries to access a resource such as a connected app, report, or dashboard that requires a high assurance session level.
This field is available in API version 43.0 and later.
SourceIp
Type
string
Properties
Nillable
Description
The source IP address of the client that logged in. For example, 126.7.4.2. This field is available in API version 43.0 and later.
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.

Usage

The AdminSetupEvent tracks user operations involving managing encryption keys in your organization. Following is example data when a user was blocked from accessing the Key Management Setup page.

Example row showing Block

Following is example data when a user was blocked from reading the TenantSecret object.

Example row showing Block on TenantSecret

Following is example data when there was no action (policy didn’t trigger) when a user accessed the Encryption Policy Setup page.

Example row showing NoAction on Encryption Policy page