DocumentationRelease Notes
Log In
Documentation

Syslog fields

Many of the triggering events related to the BeyondTrust Administrative Interface (/login) and the B Series Appliance Interface (/appliance) result in syslog messages. These syslog messages have additional fields associated.

You can configure your B Series Appliance to send these log message to an existing syslog server. B Series Appliance logs are sent using the local0 facility.

Account

These fields apply to the account_added, account_changed, and account_removed events.

FieldValueExplanation
namestringThe name of the vault account.
usernamestringThe username of the vault account.
password***Indicates if the password has changed. The actual string is never supplied.
auto_rotate_credentials1 or 01: Enables the automatic rotation for this vault account.
0: Disables the automatic rotation for this vault account.
allow_simultaneous_checkout1 or 01: Account can be checked out and used by multiple users or sessions at the same time.
0: Account can be checked out and used by a single user at one time.
personal1 or 01: Is a personal account.
0: Is a shared account.
groupstringThe unique identifier of the account group.

Account group

These fields apply to the account_group_added, account_group_changed, and account_group_removed events.

FieldValueExplanation
idstringThe unique identifier of the account group.
namestringThe name of the account group.
descriptionstringThe description of the account group.

Account group membership

These fields apply to the accounts_changed event.

FieldValueExplanation
accounts_idcomma-delimited listThe unique identifier of the vault accounts.
new_groupstringThe unique identifier of the target account group.

Account Jump Item association

These fields apply to the account_jump_item_association_added and account_jump_item_association_removed events.

FieldValueExplanation
idnumberThe unique identifier of the association.
account_group_idnumberThe unique identifier of the account group.
account_idnumberThe unique identifier of the account.
criteriastringA JSON representation of the filters Eg. {"name":["name"],"host":["hostname"],"tag":["tag"],"comment":["comments"],"shared_jump_groups":[3]} Valid only when the filter type is criteria.
filter_typeapplicable
not_injectable
criteria
The filter type of the association.

Account user

These fields apply to the account_user_added and account_user_removed events.

FieldValueExplanation
account:idstringThe unique identifier of the vault account.
rolestringThe role associated with the vault account. The two possible options are Inject and Inject and Checkout.
user:idstringThe unique identifier of the user associated with this vault account.

API account

These fields apply to the api_account_added, api_account_changed, and api_account_removed events.

FieldValueExplanation
client_idstringThe OAuth client ID.
client_secret***Indicates the OAuth client secret. The actual string is never supplied.
commentsstringAny comments associated with this API account.
ecm_groupstringThe ID of the ECM Group that the account belongs to.
enabled1 or 01: This API account is enabled.
0: This API account is disabled.
idstringThe unique identifier of the API account.
ip_addressescomma-delimited listThe list of network address prefixes from which this account can authenticate.
namestringThe name of the API account.
permissions:backup1 or 01: This API account may use the backup API.
0: This API account may not use the backup API.
permissions:commanddeny
read_only
full_access
Whether this API account is disallowed to use the command API, has read-only access to the command API, or has full access to the command API.
permissions:ecm1 or 01: This API account may use the Endpoint Credential Manager API.
0: This API account may not use the Endpoint Credential Manager API.
permissions:reporting:support1 or 01: This API account may use the reporting API.
0: This API account may not use the reporting API.
permissions:scim1 or 01: The API account may use the SCIM API.
0: The API account may not use the SCIM API.
permissions:reporting:syslogdeny
read_only
full_access
Whether this API account is disallowed access syslog reports, has read-only access to syslog reports, or has full access to syslog reports.

Canned script

These fields apply to the canned_script_added, canned_script_changed, and canned_script_removed events.

FieldValueExplanation
allowed_in_view_only1 or 01: This canned script is available in view-only screen sharing, as a special action.
0: This canned script is not available in view-only screen sharing.
commandsstringThe commands to be executed when this script is run.
descriptionstringThe description of this canned script as displayed to the user before being run.
elevation_modeBoth
Elevated Only
Unelevated Only
Whether this canned script is available only in elevated mode, only in unelevated mode, or in both elevated and unelevated modes.
idstringThe unique identifier of this canned script.
namestringThe name of this canned script.

Canned script category

These fields apply to the canned_script_category_added and canned_script_category_removed events.

FieldValueExplanation
canned_script:idstringThe unique identifier of the canned script to which this category is being applied.
canned_script:namestringThe name of the canned script to which this category is being applied.
categorystringThe name of the category being applied to this canned script.

Canned script file

These fields apply to the canned_script_file_added and canned_script_file_removed events.

FieldValueExplanation
canned_script:idstringThe unique identifier of the canned script with which this file is being associated.
canned_script:namestringThe name of the canned script with which this file is being associated.
filenamestringThe name of the file being associated with this canned script.

Canned script team

These fields apply to the canned_script_team_added and canned_script_team_removed events.

FieldValueExplanation
canned_script:idstringThe unique identifier of the canned script to which this team is being given access.
canned_script:namestringThe name of the canned script to which this team is being given access.
team:idstringThe unique identifier of the team being given access to this script.
team:namestringThe name of the team being given access to this script.

Canned scripts category fields

These fields apply to the canned_scripts_category_added and canned_scripts_category_removed events.

FieldValueExplanation
categorystringThe name of this canned script category.

Canned scripts file

These fields apply to the canned_scripts_file_added and canned_scripts_file_removed events.

FieldValueExplanation
filenamestringThe filename of the file uploaded for canned script use.

Certificate export

These fields apply to the certificate_export event.

FieldValueExplanation
friendly_namestringThe friendly name of the certificate being exported.
exported_with_private_key1 or 01: The private key is included in this export.
0: The private key is not included in this export.

Change display name

These fields apply to the change_display_name event.

FieldValueExplanation
statussuccess failureWhether the display name change attempt succeeded or failed.
reasonfailed
invalid display name
Indicates whether the new display name failed to meet formatting requirements.
targetweb/api
web/login
The authentication area from which the username change attempt was made.

Change password

These fields apply to the change_password event.

FieldValueExplanation
statussuccess
failure
Whether the password change attempt succeeded or failed.
reasonfailed
invalid password
Indicates whether the old password supplied was incorrect or the new password failed to meet complexity requirements.
targetweb/api
web/appliance
web/login
The authentication area from which the password change attempt was made.

Change username

These fields apply to the change_username event.

FieldValueExplanation
statussuccess
failure
Whether the username change attempt succeeded or failed.
reasonfailed
invalid password
Indicates whether the supplied password was incorrect or the new username failed to meet formatting requirements.
targetweb/api
web/appliance
web/login
The authentication area from which the password change attempt was made.

Custom session attribute

These fields apply to the custom_session_attribute_added, custom_session_attribute_changed, and custom_session_attribute_removed events.

FieldValueExplanation
code_namestringThe code name of the custom session attribute.
display_namestringThe display name of the custom session attribute.
idstringThe unique identifier of the custom session attribute.
show_in_rep1 or 01: The custom session attribute will be displayed in the access console during an access session.
0: The custom session attribute will not be displayed in the access console.

Custom session policy

These fields apply to the custom_session_policy_added, custom_session_policy_changed, and custom_session_policy_removed events. Custom session policy events also include the Support permissions fields.

FieldValueExplanation
code_namestringThe code name of this custom session policy.
descriptionstringThe description of the object to which this custom session policy is applied in the form of object(type):name. The object may be one of users or policies. A users object is followed by @ and the ID of its security provider. The type is either attended or unattended. The name is the name of the object.
idstringThe unique identifier of this custom session policy.
namestringThe name of this custom session policy. This name is assigned by the B Series Appliance and cannot be modified.

Custom rep link

These fields apply to the custom_rep_link_added, custom_rep_link_changed, and custom_rep_link_removed events.

FieldValueExplanation
idstringThe unique identifier of the custom link.
namestringThe name of the custom link.
urlstringThe URL of the custom link.

Custom special action

These fields apply to the custom_special_action_added, custom_special_action_changed, and custom_special_action_removed events.

FieldValueExplanation
argumentslistCommand line arguments to apply the command.
commandstringThe full path of the application to run.
confirm1 or 01: Require users to answer a confirmation prompt before the action runs.
0: Do not prompt before running the action.
idstringThe unique identifier of this custom special action.
namestringThe name of this custom special action.
run_elevated1 or 01: Show the special action only when the endpoint client is running in elevated mode, and run the action with elevated privileges.
0: Always show the action, and run the action with user privileges.

Customizable text

These fields apply to the customizable_text_changed event.

FieldValueExplanation
pre_login_agreement:body:[language]stringThe existing message for the /login prerequisite login agreement has changed.
pre_login_agreement:title:[language]stringThe existing title for the /login prerequisite login agreement has changed.
rep:invite:email:body:[language]stringThe existing message for an access invitation email has changed.
rep:invite:email:subject:[language]stringThe existing subject for an access invitation email has changed.

ℹ️

Note

Macros appear as %MACROS% to indicate use.

Discovery error

These fields apply to the discovery_error_added, discovery_error_changed, and discovery_error_removed events.

FieldValueExplanation
system_namestringThe hostname or computer name which this error belongs.
discovery_job_idstringThe unique identifier of the Discovery job to which this error belongs.
typeintegerThe type of error.
user_errorstringThe error description.

Domain

These fields apply to the domain_added, domain_changed, and domain_removed events.

FieldValueExplanation
namestringThe name of the domain.
jumpoint:idstringThe unique identifier of the Jumpoint.

ECM group

These fields apply to the ecm_group_added, ecm_group_changed, and ecm_group_removed events.

FieldValueExplanation
idstringThe unique identifier of the ECM Group.
namestringThe name of the ECM Group.

Endpoint

These fields apply to the endpoint_changed and endpoint_removed events.

FieldValueExplanation
distinguished_namestringThe distinguished name of the endpoint.
domain_idintegerThe unique identifier of the Domain to which this endpoint belongs.
unique_idstringThe unique identifier of the endpoint.
namestringThe name of the endpoint.
hostnamestringThe hostname of the endpoint.
descriptionstringThe description of the endpoint.
is_domain_controller1 or 01: The endpoint is a domain controller.
0: The endpoint is not a domain controller.
operating_systemstringThe operating system of the endpoint.

Endpoint automation resource

These fields apply to the endpoint_automation_resource_added, endpoint_automation_resource_changed, and endpoint_automation_resource_removed events.

FieldValueExplanation
idstringThe unique identifier of the endpoint automation resource.
file_namestringThe name of the endpoint automation resource.
sizeintegerThe size of the file in bytes.
hashstringThe hash value of the file.
URLstringThe download string of the file.

EULA accepted

These fields apply to the eula_accepted event.

FieldValueExplanation
auth_usernamestringThe username of the individual who accepted the BeyondTrust PRA Cloud end user license agreement (EULA).

FIDO2 credential

These fields apply to the fido2_credential_added, fido2_credential_changed, and fido2_credential_removed events.

FieldValueExplanation
credential_owner_idintegerID of the credential owner.
namestringUnique name of the credential, up to 64 characters.
roaming1 or 01: The credential is cross-platform.
2: The credential is not cross-platform.
registration_datedateThe date the credential was registered.
last_used_datedateThe date the credential was last used.
last_signature_countintegerHow many times this authenticator has performed signatures.

File store

These fields apply to the file_removed_from_file_store and file_uploaded_to_file_store events.

Fields marked with an asterisk apply only to file_uploaded_to_file_store events.

FieldValueExplanation
filenamestringThe name of the file being uploaded to or removed from the file store.
size*integerThe size in bytes of the file being uploaded to the file store.

Group policy

These fields apply to the group_policy_added, group_policy_changed, and group_policy_removed events. Group policy events also include the Permission fields.

FieldValueExplanation
account:disabled1 or 01: The accounts associated with this group policy are disabled.
0: The accounts associated with this group policy are active.
account:expirationUnix timestampThe date and time the accounts associated with this group policy will expire, if ever.
allow_override1 or 01: This setting can be overridden by a policy with a lower priority.
0: This setting cannot be overridden by a policy with a lower priority.
commentsstringAny comments associated with this group policy.
idstringThe unique identifier for this group policy.
idle_timeoutinteger or
site_wide_setting
The maximum number of seconds these users can be idle within the access console before being logged out. The site_wide_setting option defaults to the timeout set on the Management > Security page. If no timeout, uses none.
jumpointsserialized labeled listThe group's Jumpoint access in the form of permission🆔name, where permission is one of added, removed, or unknown; id is the unique identifier of the Jumpoint; and name is the name of the Jumpoint.
login_code:enabled1 or 01: Users must enter an emailed login code to log in.
0: Users may log in without an emailed login code.
namestringThe name of this group policy.
policy:idstringThe unique identifier of the group policy for which this setting is configured.
policy:namestringThe name of the group policy for which this setting is configured.
priorityintegerThe priority of this group policy, in order of execution, starting from 1.
tzstringThe time zone to use for the login schedule for this group policy.

Group policy add to Jump Group

These fields apply to the group_policy_add_to_jump_group_added and group_policy_add_to_jump_group_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
jump_group:idstringThe unique identifier of the Jump Group to which members of this group policy should be added.
jump_group:namestringThe name of the Jump Group to which members of this group policy should be added.
jump_item_role:idstringThe unique identifier of the Jump Item Role to assign to members of this group policy specific to this Jump Group.
jump_item_role:namestringThe name of the Jump Item Role to assign to members of this group policy specific to this Jump Group.
jump_policy:idstringThe unique identifier of the Jump Policy to assign to members of this group policy specific to this Jump Group.
jump_policy:namestringThe name of the Jump Policy to assign to members of this group policy specific to this Jump Group.

Group policy add to Jumpoint

These fields apply to the group_policy_add_to_jumpoint_added and group_policy_add_to_jumpoint_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
jumpoint:idstringThe unique identifier of the Jumpoint to which members of this group policy should be added.
jumpoint:namestringThe name of the Jumpoint to which members of this group policy should be added.

Group policy add to teams

These fields apply to the group_policy_add_to_support_teams_added and group_policy_add_to_support_teams_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
rolemember
lead
manager
The role assigned to members of this group policy specific to the team.
support_team:idstringThe unique identifier of the team to which members of this group policy should be added.
support_team:namestringThe name of the team to which members of this group policy should be added.

Group policy member

These fields apply to the group_policy_member_added and group_policy_member_removed events.

FieldValueExplanation
policy:idstringThe unique identifier of the policy to which this member belongs.
policy:namestringThe name of the policy to which this member belongs.
provider:idstringThe unique identifier of the security provider against which this member authenticates.
provider:namestringThe name of the security provider against which this member authenticates.
user:external_idstringThe unique identifier of this group policy member.

Group policy remove from Jump Group

These fields apply to the group_policy_remove_from_jump_group_added and group_policy_remove_from_jump_group_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
jump_group:idstringThe unique identifier of the Jump Group from which members of this group policy should be removed.
jump_group:namestringThe name of the Jump Group from which members of this group policy should be removed.
jump_item_role:idstringThe unique identifier of the Jump Item Role to assign to members of this group policy specific to this Jump Group.
jump_item_role:namestringThis field will always be empty.
jump_policy:idstringThe unique identifier of the Jump Policy to assign to members of this group policy specific to this Jump Group.
jump_policy:namestringThis field will always be empty.

Group policy remove from Jumpoint

These fields apply to the group_policy_remove_from_jumpoint_added and group_policy_remove_from_jumpoint_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
jumpoint:idstringThe unique identifier of the Jumpoint from which members of this group policy should be removed.
jumpoint:namestringThe name of the Jumpoint from which members of this group policy should be removed.

Group policy remove from teams

These fields apply to the group_policy_remove_from_support_teams_added and group_policy_remove_from_support_teams_removed events.

FieldValueExplanation
group_policy:idstringThe unique identifier of this group policy.
group_policy:namestringThe name of this group policy.
rolemember
lead
manager
The role assigned to members of this group policy specific to the team.
support_team:idstringThe unique identifier of the team from which members of this group policy should be removed.
support_team:namestringThe name of the team from which members of this group policy should be removed.

Jump Item Role

These fields apply to the jump_item_role_added, jump_item_role_changed, and jump_item_role_removed events.

FieldValueExplanation
commentsstringAny comments on this Jump Item.
computer_namestringThe hostname or IP address, up to 64 characters.
descriptionstringThe description of this Jump Item Role.
idstringThe unique identifier of this Jump Item Role.
jump_group_idintegerThe unique identifier of the Jump Group or user that owns this Jump Item.
jump_policy_idintegerThe unique identifier of the Jump Policy used to manage access to this Jump Item.
namestringThe name of this Jump Item Role.
perm_add1 or 01: This role grants permission to create and deploy Jump Items.
0: This role does not grant permission to create Jump Items.
perm_assign_jump_group1 or 01: This role grants permission to move Jump Items into and out of Jump Groups.
0: This role does not grant permission to move Jump Items between Jump Groups.
perm_edit_behavior1 or 01: This role grants permission to edit Jump Item behavior and experience settings.
0: This role does not grant permission to edit behavior and experience settings.
perm_edit_comments1 or 01: This role grants permission to edit Jump Item comments.
0: This role does not grant permission to edit comments.
perm_edit_identity1 or 01: This role grants permission to edit Jump Item connectivity and authentication settings.
0: This role does not grant permission to edit connectivity and authentication settings.
perm_edit_jump_policy1 or 01: This role grants permission to assign Jump Policies to Jump Items.
0: This role does not grant permission to assign Jump Policies to Jump Items.
perm_edit_session_policy1 or 01: This role grants permission to assign session policies to Jump Items.
0: This role does not grant permission to assign session policies to Jump Items.
perm_edit_tag1 or 01: This role grants permission to edit Jump Item tags.
0: This role does not grant permission to edit tags.
perm_remove1 or 01: This role grants permission to delete Jump Items.
0: This role does not grant permission to delete Jump Items.
perm_start1 or 01: This role grants permission to start sessions with Jump Items.
0: This role does not grant permission to start sessions with Jump Items.
perm_view_jump_item_report1 or 01: This role grants permission to view Jump Item reports.
0: This role does not grant permission to view Jump Item reports.
portintegerThe port for this Jump Item to use.
push_agent_idintegerThe unique identifier of the Jumpoint through which connections are made.
tagstringThe tag for this Jump Item.

Jump Policy

These fields apply to the jump_policy_added, jump_policy_changed, and jump_policy_removed events.

FieldValueExplanation
authorization:allowed_to1 or 01: Access approval applies to anyone with permission to request access.
0: Access approval applies only to the requestor.
authorization:allowed_approvers1 or 01: Approvers can approve all requests including their own.
0: Approvers can approve all requests except their own.
authorization:approver_namestringThe name of the approval email recipient.
authorization:approversstringThe IDs of approver users.
authorization:email_addressesstringThe email addresses to which approval emails are sent.
authorization:enabled1 or 01: Require approval before a session starts.
0: Do not require approval.
authorization:locale_codestringValues are the language abbreviations (e.g. en-us for English) used with approval emails.
authorization:max_durationintegerThe maximum length of time in seconds for which a user can request access.
authorization:ticket_system_enabled1 or 01: Require a ticket ID before a session can start.
0: Do not require a ticket ID.
code_namestringThe code name of this Jump Policy.
descriptionstringThe description of this Jump Policy.
display_namestringThe display name of this Jump Policy.
idstringThe unique identifier of this Jump Policy.
notification:email_addressesstringThe email addresses to which notification emails are sent.
notification:locale_codestringValues are the language abbreviations (e.g. en-us for English) used with notification emails.
notification:recipient_namestringThe name of the notification email recipient.
notify_on_customer_leave1 or 01: Notify recipients when a session ends.
0: Do not notify recipients when a session ends.
notify_on_session_start1 or 01: Notify recipients when a session starts.
0: Do not notify recipients when a session starts.
schedule:enabled1 or 01: Users are disallowed to access Jump Items controlled by this policy outside of the set schedule.
0: Users may access Jump Items controlled by this policy at any time.
schedule:force_end1 or 01: Open sessions with Jump Items controlled by this policy are automatically terminated at the end of the scheduled time.
0: Open sessions with Jump Items controlled by this policy may continue past the end of the scheduled time.
session_recordings_disabled1 or 01: Disable session recordings for Jump Items controlled by this policy.
0: Do not disable session recordings.

Jump Policy schedule entry

These fields apply to the jump_policy:schedule_entry_added and jump_policy:schedule_entry_removed events.

FieldValueExplanation
jump_policy:display_namestringThe display name of the Jump Policy to which this Jump schedule entry applies.
jump_policy:idstringThe unique identifier of the Jump Policy to which this Jump schedule entry applies.
schedule:end_day_of_weekMonday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
The end day for this Jump schedule entry.
schedule:end_time_of_dayhh:mm (24-hour format)The end time for this Jump schedule entry.
schedule:start_day_of_weekMonday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
The start day for this Jump schedule entry.
schedule:start_time_of_dayhh:mm (24-hour format)The start time for this Jump schedule entry.

Jumpoint cluster

These fields apply to the jumpoint_cluster_added, jumpoint_cluster_changed, and jumpoint_cluster_removed events.

FieldValueExplanation
allows_multiple_nodes1 or 01: This is a Jumpoint cluster.
0: This is a standalone Jumpoint.
code_namestringThe code name of this Jumpoint or Jumpoint cluster.
commentsstringAny comments associated with this Jumpoint or Jumpoint cluster.
disabled1 or 01: This Jumpoint or Jumpoint cluster is disabled.
0: This Jumpoint or Jumpoint cluster is enabled.
external_jump_item_network_idstringThe unique identifier of the external Jump Item.
idstringThe unique identifier of this Jumpoint or Jumpoint cluster.
namestringThe name of this Jumpoint or Jumpoint cluster.
network_tunnel1 or 01: This Jumpoint or Jumpoint cluster can be configured to allow Protocol Tunnel Jumps”.
0: This Jumpoint or Jumpoint cluster does not allow Protocol Tunnel Jumps.
platformstringThe platform of the Jumpoint cluster.
rdp_service_account_idstringThe Vault Account ID used to deploy an ad hoc client to RDP servers when Session Forensics is enabled.
shelljump1 or 01: This Jumpoint or Jumpoint cluster can be configured to allow Shell Jump.
0: This Jumpoint or Jumpoint cluster does not allow Shell Jump.

Jumpoint user

These fields apply to the jumpoint_user_added and jumpoint_user_removed events.

FieldValueExplanation
jumpoint:idstringThe unique identifier of the Jumpoint to which this user is being added or removed.
jumpoint:namestringThe name of the Jumpoint to which this user is being added or removed.
user:idstringThe unique identifier of the user being added or removed.
user:usernamestringThe name of the user being added or removed.

Kerberos keytab

These fields apply to the kerberos_keytab_added and kerberos_keytab_removed events.

Fields marked with an asterisk apply only to kerberos_keytab_added events.

FieldValueExplanation
enctype*stringThe encryption type of the keytab.
principalstringThe service principal of the keytab.
timestamp*Unix timestampThe timestamp of the keytab.
vno*integerThe key version number of the keytab.

Login

These fields apply to the login event, triggered from the administrative interface or the access console.

FieldValueExplanation
last_notifiedstringThe last time the user was notified to take an action.
statussuccess
failure
Whether the login attempt succeeded or failed.
reasonfailed
account disabled
account expired
exceeded failed login attempts
change password
Appears only if login failed. Indicates the reason for the failure, such as the account being disabled or expired, the number of failed login attempts having exceeded the permissible amount, or the password requiring reset.
targetweb/api
web/appliance
web/login
rep_client
The authentication area from which the login attempt was made.
vendor_expire_timestringThe Vendor user expiration datetime.

Login schedule entry

These fields apply to the login_schedule_entry_added and login_schedule_entry_removed events.

FieldValueExplanation
schedule:end_day_of_weekMonday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
The end day for this login schedule entry.
schedule:end_time_of_dayhh:mm (24-hour format)The end time for this login schedule entry.
schedule:start_day_of_weekMonday
Tuesday
Wednesday
Thursday
Friday
Saturday
Sunday
The start day for this login schedule entry.
schedule:start_time_of_dayhh:mm (24-hour format)The start time for this login schedule entry.
user:idstringThe unique identifier of the user to whom this login schedule entry applies.
user:usernamestringThe username of the user to whom this login schedule entry applies.

Management account

These fields apply to the management_ account_added, management_account_changed, and management_account_removed events.

FieldValueExplanation
domain_account:idstringThe unique identifier of the domain account.
domain:idstringThe unique identifier of the domain.

MSGraph HTTP recipient

These fields apply to the msgraph_http_recipient_added, msgraph_http_recipient_changed, and msgraph_http_recipient_removed events.

FieldValueExplanation
client_idstringThe client ID of this service principal.
disabled1 or 01: Enable team chat history.
0: Disable team chat history.
current_statusstringThe last status of this service principal.
domain_namestringThe domain name of this service principal.
namestringInternal descriptive name to easily identify the service principal.
tenant_idstringThe tenant ID of this service principal.

Perm remote shell allow list

This field applies to the perm_remote_shell_Allow list event.

FieldValueExplanation
support:permissions:command_shell_is_Allow list0, 1, or 2Integer denoting command filtering options.0: Allow all commands
1: White-list command
2: Black-list command

Network

These fields apply to the network_changed event.

FieldValueExplanation
default_routestringThe default network route for the B Series Appliance.
dns:1stringThe IP address of the primary DNS server.
dns:2stringThe IP address of the secondary DNS server.
dns:3stringThe IP address of the tertiary DNS server.
dns:opendns1 or 01: The B Series Appliance should fall back to OpenDNS servers if the configured DNS servers fail to reply.
0: The B Series Appliance should never fall back to OpenDNS servers.
gateway:interfacestringThe interface to use as the default gateway.
gateway:ipstringThe IP address of the default gateway.
hostnamestringThe hostname of the B Series Appliance.
icmp_echo1 or 01: The interface will respond to ICMP echoes.
0: The interface will not respond to ICMP echoes.
ntp_serverstringThe IP address of the NTP server.
ssl:cipherscomma-delimited listThe set of ciphersuites supported by the B Series Appliance for HTTPS/SSL traffic.
ssl:v21 or 01: SSLv2 is enabled.
0: SSLv2 is not enabled.
ssl:v31 or 01: SSLv3 is enabled.
0: SSLv3 is not enabled.

Network address

These fields apply to the network_address_added, network_address_changed, and network_address_removed events.

FieldValueExplanation
enabled1 or 01: This IP address is enabled.
0: This IP address is disabled.
interfacestringThe NIC to use as the interface.
ipstringThe IP address of the interface.
netmaskstringThe netmask for this IP address.
permit:http1 or 01: Permit HTTP traffic through this IP and interface.
0: Do not permit HTTP traffic through this IP and interface.
permit:https1 or 01: Permit HTTPS traffic through this IP and interface.
0: Do not permit HTTPS traffic through this IP and interface.
permit:session1 or 01: Permit BeyondTrust session traffic, such as access console and endpoint client connections, through this IP and interface.
0: Do not permit BeyondTrust session traffic through this IP and interface.

Network route descriptor

This field applies to the network_route_changed event.

FieldValueExplanation
[ip/bit=gw@NIC]stringThe IP address and CIDR bitmask, along with the gateway address at a particular interface.

Network Tunnel Jump

These fields apply to the network_tunnel_jump_item_added, network_tunnel_jump_item_changed, and network_tunnel_jump_item_removed events.

FieldValueExplanation
idstringThe unique identifier of the network tunnel Jump Item.
namestringThe name of the network tunnel Jump Item.
push_agent_idnumberThe unique identifier of the push agent.
jump_group_idnumberThe unique identifier of the Jump Group.
tagstringThe tag of the network tunnel Jump Item.
commentsstringThe comments of the network tunnel Jump Item.
jump_policy_idnumberThe unique identifier of the jump_policy_id.
unattended_support_access_policy_idnumberThe unique identifier of the session policy.
computer_namestringThe computer name of the network tunnel Jump Item.
tunnel_tcp_definitionsstringThe definitions of the network tunnel Jump Item.
tunnel_tcp_listen_addressstringThe listen address of the network tunnel Jump Item.
usernamestringThe username used by the SQL Tunnel type.
databasestringThe database used by the SQL Tunnel type.
urlstringThe url used by the Web Jump Tunnel type.
cacertsstringThe certificates used by the Kubernetes Tunnel type.

Outbound event email recipient

These fields apply to the outbound_event_email_recipient_added, outbound_event_email_recipient_changed, and outbound_event_email_recipient_removed events.

FieldValueExplanation
disabled1 or 01: The outbound event email recipient is disabled.
0: The outbound event email recipient is enabled.
email_addressstringThe email address to which the outbound event is sent.
idstringThe unique identifier of this outbound event email recipient.
namestringThe name of this outbound event email recipient.
require_external_key1 or 01: Emails are sent only for sessions that have an external key at the time the event occurs.
0: Emails are sent for all sessions, even those that do not have an external key.

Outbound event email trigger

These fields apply to the outbound_event_email_trigger_added and outbound_event_email_trigger_removed events.

FieldValueExplanation
event:email :bodystringThe body of the email sent to the recipient.
event:email :enabled1 or 01: The email event is enabled.
0: The email event is disabled.
event:email :subjectstringThe subject of the email sent to the recipient.
recipient:idstringThe unique identifier of the recipient to which this event will be emailed.
recipient:namestringThe name of the recipient to which this event will be emailed.

Outbound event HTTP recipient

These fields apply to the outbound_event_http_recipient_added, outbound_event_http_recipient_changed, and outbound_event_http_recipient_removed events.

FieldValueExplanation
cert<data>
none
Indicates that a certificate has been uploaded or changed. Only the value <data> will be displayed for a changed certificate.
disabled1 or 01: The outbound event recipient is disabled.
0: The outbound event recipient is enabled.
failure:emailstringThe email address to which to send a failure notification if the outbound event cannot be posted.
failure:first_noticeintegerThe number of seconds that must have elapsed since the first error before sending a failure notification email.
failure:repeat_intervalintegerThe number of seconds that must have elapsed since the last alert was sent before sending another failure notification email if the event is still failing.
idstringThe unique identifier of this outbound event recipient.
namestringThe name of this outbound event recipient.
retry:durationintegerThe number of seconds that must have elapsed since the first error before the event stops retrying and is marked as failed.
retry:intervalintegerThe number of seconds between each retry attempt.
urlstringThe URL of the outbound event recipient to which the event will be posted.

Outbound event HTTP trigger

These fields apply to the outbound_event_http_trigger_added and outbound_event_http_trigger_removed events.

FieldValueExplanation
event:namesupport_conference_begin
support_conference_end
support_conference_owner_changed
support_conference_member_added
support_conference_member_departed
The event to send to the recipient. There will be one event per post, with multiple events resulting in multiple posts to the recipient.
recipient:idstringThe unique identifier of the recipient to which this event will be posted.
recipient:namestringThe name of the recipient to which this event will be posted.

Pending user

These fields apply to the pending_user_added, pending_user_changed, and pending_user_removed events.

FieldValueExplanation
namestringThe user name.
usernamestringThe user username.
email_addressstringThe user email address.
idstringThe user id.
vendor_idstringThe unique identifier of the Vendor to which this user belongs.
email_languageintegerThe unique identifier of the email selected language.
email_address_confirmed0 or 11:The user has confirmed their email address.
0: The user has not confirmed their email address.
commentsstringThe user comments.

Permission

These fields apply to both user and group policy events.

FieldValueExplanation
permissions:admin1 or 01: The user is an administrator.
0: The user is not an administrator.
permissions:api:command1 or 01: The user is allowed to use the command API.
0: The user is not allowed to use the command API.
permissions:api:reporting1 or 01: The user is allowed to use the reporting API.
0: The user is not allowed to use the reporting API.
permissions:api:state1 or 01: The user is allowed to use the real-time state API.
0: The user is not allowed to use the real-time state API.
permissions:canned_scripts1 or 01: The user may create and edit canned scripts.
0: The user may not create or edit canned scripts.
permissions:change_display_name1 or 01: The user may change their display name.
0: The user may not change their display name.
permissions:custom_rep_links1 or 01: The user may create and edit custom rep links.
0: The user may not create or edit custom rep links.
permissions:file_store1 or 01: The user may add or remove files from the file store.
0: The user may not edit the file store.
permissions:issues1 or 01: The user may create and edit issues.
0: The user may not create or edit issues.
permissions:jump_groups1 or 01: The user may edit Jump Groups.
0: The user may not edit Jump Groups.
permissions:jump_item_role:default:idstringThe unique identifier of this user's default Jump Item Role.
permissions:jump_item_role:default:namestringThe name of this user's default Jump Item Role.
permissions:jump_item_role:personal:idstringThe unique identifier of this user's personal Jump Item Role.
permissions:jump_item_role:personal:namestringThe name of this user's personal Jump Item Role.
permissions:jump_item_role:system:idstringThe unique identifier of this user's system Jump Item Role.
permissions:jump_item_role:system:namestringThe name of this user's system Jump Item Role.
permissions:jump_item_role:teams:idstringThe unique identifier of this user's team Jump Item Role.
permissions:jump_item_role:teams:namestringThe name of this user's team Jump Item Role.
permissions:rep_to_rep_screen_sharing1 or 01: The user is allowed to show their screen to other users outside of a session.
0: The user is not allowed to show their screen to other users.
permissions:rep_to_rep_screen_sharing:control1 or 01: When showing their screen to another user, the user is allowed to grant control to the viewing user.
0: When showing their screen to another user, the user is not allowed to grant control to the viewing user.
permissions:reporting:license_reports1 or 01: The user is allowed to view license usage reports.
0: The user is not allowed to view license usage reports.
permissions:reporting:recordings1 or 01: The user is allowed to view support session recordings.
0: The user is not allowed to view session recordings.
permissions:reporting:support_reportsnone
user_sessions
team_sessions
all_sessions
Whether the user is disallowed to generate reports or is allowed to generate reports only for sessions in which they were the primary user, for sessions in which one of their teammates was the primary user or one of their teams was the primary team, or for all sessions.
permissions:supportnot_allowed
full_support
chat_only
Whether the user is disallowed to offer support or is allowed to offer full remote support. The user may also be allowed only to send chat messages within a session.
permissions:support:extended_availability_mode1 or 01: The user is allowed to enable extended availability.
0: The user is not allowed to enable extended availability.
permissions:support:external_key*1 or 01: The user is allowed to edit the external key.
0: The user is not allowed to edit the external key.
permissions:support:invite_temp_rep1 or 01: The user is allowed to invite an external user into a single session.
0: The user is not allowed to invite an external user into a session.
permissions:support:jump:clients1 or 01: The user is allowed to Jump to unattended systems via preinstalled Jump Clients.
0: The user is not allowed to Jump to unattended systems via pre-installed Jump Clients.
permissions:support:jump:local1 or 01: The user is allowed to Jump to unattended computers on the same network without Jump Clients or a Jumpoint.
0: The user is not allowed to Jump to computers on the same network without Jump Clients or a Jumpoint.
permissions:support:jump:remote1 or 01: The user is allowed to Jump to unattended remote computers through a Jumpoint.
0: The user is not allowed to Jump to unattended remote computers through a Jumpoint.
permissions:support:jumpoint:admin1 or 01: The user is allowed to create and edit Jumpoints.
0: The user is not allowed to create or edit Jumpoints.
permissions:support:jumpoint:shell1 or 01: The user is allowed to use Shell Jump.
0: The user is not allowed to use Shell Jump.
permissions:support:rdp:remote1 or 01: The user is allowed to use BeyondTrust to start a Remote Desktop Protocol (RDP) session with a computer on a remote network.
0: The user is not allowed to use BeyondTrust for RDP on a remote network.
permissions:support:team_share1 or 01: The user can share sessions with teams to which they do not belong.
0: The user cannot share sessions with teams to which they do not belong.
permissions:support:vnc:remote1 or 01: The user is allowed to use BeyondTrust to start a VNC session with a computer on a remote network.
0: The user is not allowed to use BeyondTrust for VNC on a remote network.
permissions:support:vpro1 or 01: The user is allowed to control a computer using Intel® vPro Technology.
0: The user is not allowed to control a computer using Intel® vPro Technology.
permissions:teams1 or 01: The user is allowed to create and edit teams.
0: The user is not allowed to create or edit teams.
permissions:users:set_passwords1 or 01: The user is allowed to reset other users' passwords.
0: The user is not allowed to reset other users' passwords.

Perm remote shell filter commands

This field applies to the perm_remote_shell_filter_commands event.

FieldValueExplanation
support:permissions:command_shell_commandsstringList of the command patterns that are white-listed or black-listed.

Public site portal logo

These fields apply to the public_site_portal_logo_uploaded event.

FieldValueExplanation
site:idstringThe unique identifier of the public site to which this logo image is assigned. This will always be 1.
site:namestringThe name of the public site to which this logo image is assigned. This will always be Default.
sizeintegerThe size in bytes of the custom logo image. Applies only to new images being uploaded.

Public site session attribute

These fields apply to the public_site_session_attribute_added, public_site_session_attribute_changed, public_site_session_attribute_removed events.

FieldValueExplanation
public_site:idstringThe public site unique identifier.
public_site:namestringThe public site name.
attribute:idstringThe unique identifier of the attribute.
attribute:code_namestringThe attribute code name
attribute:display_numberstringThe unique identifier of the Vendor to which this user belongs.
attribute:required0 or 11: The attribute is required.
0: The attribute is not required.

Remote RFB Jump Item

These fields apply to the remote_rfb_jump_item_added and remote_rfb_jump_item_removed events.

FieldValueExplanation
idstringThe unique identifier of the Remote Rfb Jump Item to which this user is being added or removed.
computer_namestringThe hostname or computer name for the Remote RFB Jump Item.
jump_group_idstringThe unique identifier of the Jump Group.
namestringThe name for the Remote RFB Jump Item.
push_agent_idstringThe unique identifier of the push agent id.
jump_policy_idstringThe unique identifier of the Jump Policy ID.
tagstringThe tag for the Remote RFB Jump Item.
commentsstringThe comments for the Remote RFB Jump Item.
portstringThe port for the Remote RFB Jump Item.

Rep client connection

These fields apply to the rep_client_connection_terminated event.

FieldValueExplanation
display_namestringThe display name of the user whose connection to the access console has been terminated.
usernamestringThe username of the user whose connection to the access console has been terminated.

Rep console setting

These fields apply to the rep_console_setting_added, rep_console_setting_changed, and rep_console_setting_removed events.

FieldValueExplanation
rep_console_setting:alerts:chat_audible:enabled
1 or 01: Play a sound when a chat message is received.
0: Do not play a sound when a chat message is received.
rep_console_setting:alerts:chat_audible:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:alerts:chat_visual:enabled
1 or 01: Flash the application icon when a chat message is received.
0: Do not flash the application icon when a chat message is received.
rep_console_setting:alerts:chat_visual:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:alerts:queue_audible:enabled
1 or 01: Play a sound when a session enters any queue.
0: Do not play a sound when a session enters any queue.
rep_console_setting:alerts:queue_audible:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:alerts:queue_visual:enabled
1 or 01: Flash the application icon when a session enters any queue.
0: Do not flash the application icon when a session enters any queue.
rep_console_setting:alerts:queue_visual:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:automatic:local_jumps_elevate:enabled
1 or 01: Automatically elevate local network Jump attempts.
0: Do not automatically elevate local network Jump attempts.
rep_console_setting:automatic:local_jumps_elevate:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:automatic:screen_sharing:enabled
1 or 01: Automatically request screen sharing.
0: Do not automatically request screen sharing.
rep_console_setting:automatic:screen_sharing:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:automatic:session_window_detach:enabled
1 or 01: Automatically detach new session tabs into separate windows.
0: Do not automatically detach new session tabs into separate windows.
rep_console_setting:automatic:session_window_detach:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:chat_show_support_session_pop-up_notifications:enabled
1 or 01: Display a pop-up notification when a session chat is received.
0: Do not display pop-up notifications for session chat.
rep_console_setting:chat_show_support_session_pop-up_notifications:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:chat_show_team_pop-up_notifications:enabled
1 or 01: Display a pop-up notification when a team chat is received.
0: Do not display pop-up notifications for team chat.
rep_console_setting:chat_show_team_pop-up_notifications:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:chat_show_team_status_messages:enabled
1 or 01: Show status messages in team chat windows.
0: Do not show status messages in team chat windows.
rep_console_setting:chat_show_team_status_messages:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:command_history_length
integerThe number of lines of available command history.
rep_console_setting:command_history_length:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:enable_dockable_widgets:enabled
1 or 01: The session sidebar can be configured.
0: The session sidebar cannot be configured.
rep_console_setting:enable_dockable_widgets:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:pop-up:personal_queue_shared_session:enabled
1 or 01: Display a pop-up notification when a session is shared in the personal queue.
0: Do not display a pop-up notification when a session is shared in the personal queue.
rep_console_setting:pop-up:personal_queue_shared_session:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:pop-up:session_duration:enabled
integerThe number of seconds that pop-up notifications should appear.
rep_console_setting:pop-up:session_duration:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:pop-up:session_location
bottom_left
bottom_right
top_left
top_right
The location where pop-up notifications should appear.
rep_console_setting:pop-up:session_location:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:pop-up:team_queue_shared_session:enabled
1 or 01: Display a pop-up notification when a session is shared in a team queue.
0: Do not display a pop-up notification when a session is shared in a team queue.
rep_console_setting:pop-up:team_queue_shared_session:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:screen_sharing_fullscreen:enabled
1 or 01: Automatically enter full screen mode when screen sharing starts.
0: Do not automatically enter full screen mode when screen sharing starts.
rep_console_setting:screen_sharing_fullscreen:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:screen_sharing_quality
low
performance_color
performance_quality
quality
performance
lossless
low: Black and white
performance_color: Few colors
performance_quality: More colors
quality: Full color
performance: Best performance
lossless: Lossless
rep_console_setting:screen_sharing_quality:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:screen_sharing_scaling
scaled
actual
Whether screen sharing starts with the remote screen scaled to fit or at actual size.
rep_console_setting:screen_sharing_scaling:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:screen_sharing_sidebar_collapse:enabled
1 or 01: Automatically collapse the sidebar when full screen mode is used.
0: Do not automatically collapse the sidebar when full screen mode is used.
rep_console_setting:screen_sharing_sidebar_collapse:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.
rep_console_setting:spell_checking:enabled
1 or 01: Spell checking is turned on.
0: Spell checking is not turned on.
rep_console_setting:spell_checking:forced
1 or 01: The associated setting is forced.
0: The associated setting is not forced.

Rep invite

These fields apply to the rep_invite_added and rep_invite_removed events.

FieldValueExplanation
commentsstringThe description associated with the session policy used for this access invite.
namestringThe name of the session policy used for this access invite.

Rep invite setting

These fields apply to the repinvite_setting_added and repinvite_setting_removed events.

FieldValueExplanation
permissions:admin0An access invite user will never be an administrator.
permissions:supportfull_supportAn access invite user will always be allowed to offer full remote support.
repinvite:idstringThe unique identifier of the rep invite session policy to which this setting applies.
repinvite:namestringThe name of the rep invite session policy to which this setting applies.

Report

These fields apply to the support_session_report_generated, support_session_detail_generated, support_session_summary_report_generated, and team_activity_report_generated events.

FieldValueExplanation
api1 or 01: The report query was made via the API.
0: The report query was not made via the API.
computer_namestringThe computer name filter used in the query, if specified.
end_timedateThe readable date and time of the last date to be included in the report, if date filters were specified.
end_timestampUnix timestampThe exact timestamp of the last date to be included in the report, if date filters were specified.
external_keystringThe external key filter used in the query, if specified.
lseqintegerThe session sequence number used to query for a detailed session report, if specified.
lsidstringThe unique session identifier used to query for a detailed session report, if specified.
lsidscomma-separated stringsA comma-separated list of unique session identifiers used to query for multiple detailed session reports, if specified.
members_of_team_idstringThe unique identifier of the team used to filter the query to include only sessions that involved users who are members of the specified team.
members_of_team_namestringThe name of the team specified by members_of_team_id.
only_completed1 or 01: The report contains only completed sessions.
0: The report contains both completed and uncompleted sessions.
primary_rep1 or 01: The users specified by rep_id or members_of_team_id must be the primary users in the sessions returned.
0: The users specified by rep_id or members_of_team_id can be any participating user in the sessions returned.
private_ipstringThe private IP address filter used in the query, if specified.
public_ipstringThe public IP address filter used in the query, if specified.
rep_idstringThe user filter value, if specified. The value is either a unique user identifier, the string any, or the string none.
rep_namestringThe display name of the representative specified by rep_id, when applicable.
row_countintegerThe maximum number of rows to display at one time.
row_startintegerThe first row shown on this page of the report.
session_countintegerThe number of session detail reports returned in search results. This will be 0 or 1 for web requests and 0 or more for API requests.
start_timedateThe readable date and time of the first date to be included in the report, if any date filters were used.
start_timestampUnix timestampThe exact timestamp of the first date to be included in the report, if any date filters were used.
team_idstringThe team filter value, if specified. The value is either a unique team identifier, the string all, or the string none.
team_namestringThe name of the team specified by team_id, when applicable.

Reporting erasure

These fields apply to the reporting_erasure event.

FieldValueExplanation
request_dateUnix timestampThe timestamp presented in reports for the anonymization action.
subjectuser
customer
An identifier of what type of person was anonymized, either a user or an endpoint.
user_namestringThe original private display name or username of the anonymized user.
user_idstringThe user ID of the anonymized user.
support_sessions_affectedintegerThe number of support session affected by the anonymization action.
support_sessions_replacestringA comma-separated list of replacement terms used.
team_activity_affectedintegerThe number of teams affected by the anonymization action.
team_activity_replacestringA comma-separated list of replacement terms used.

Scheduled discovery job

These fields apply to the scheduled_discovery_job_added and scheduled_discovery_job_changed events.

FieldValueExplanation
domain:idnumberThe unique identifier of the domain.
enabled1 or 0The scheduled discovery job is either enabled or disabled.
endpoint_search_pathstringThe LDAP search path to discovery endpoints.
endpoint_search_ldap_filterstringThe LDAP filter to discovery endpoints.
idnumberThe unique identifier of the scheduled job.
include_domain_accounts1 or 0The discovery must include domain accounts.
include_endpoints1 or 0The discovery must include endpoints.
include_local_accounts1 or 0The discovery must include local accounts.
include_services1 or 0The discovery must include Windows services.
frequencynumberThe days when discovery will run.
start_timetimeHours and minutes when the discovery will run.
templatestringInternal use only.
push_agent_idnumberThe unique identifier of the Jumpoint.
domain_distinguished_namestringThe distinguished name of the domain.
usernamestringThe user for the discovery.
credential_idnumberThe unique identifier of the scheduled job.
domain_unique_idstringThe unique identifier of the domain.
domain_dns_namestringThe domain DNS name.
user_unique_idstringThe user unique ID.
user_distinguished_namestringThe distinguished name of the user.
management_account_domainstringThe parent domain account.
user_search_ldap_filterstringThe LDAP filter to discovery users.
user_search_pathstringThe LDAP search path to discovery users.

Security provider

These fields apply to the security_provider_added, security_provider_changed, and security_provider_removed events.

FieldValueExplanation
enabled1 or 01: The security provider is enabled.
0: The security provider is disabled.
idstringThe unique identifier of the security provider to which this setting applies.
namestringThe name of the security provider to which this setting applies.
priorityintegerThe priority of this security provider configuration, in the order in which authentication should be attempted, starting from 1. Two providers may share the same priority but only if one of these providers is a user provider and the other is a group provider.
provider_typelocal
cluster
kerberos
ldap
radius
saml
scim
The type of service this provider configuration is set to access.
service_typeusers
groups
The type of authentication or authorization information this provider supplies.

Security provider setting

These fields apply to the security_provider_setting_added, security_provider_setting_changed, and security_provider_setting_removed events.

FieldValueExplanation
cluster:modefailover
random
The mode in which this cluster is set to operate.
cluster:retry:delayintegerThe number of seconds to wait after a cluster member becomes unavailable before trying that cluster member again.
default_group_policy:idstringThe unique identifier of the default group policy to apply to users who authenticate against this security provider.
default_group_policy:namestringThe name of the default group policy to apply to users who authenticate against this security provider.
kerberos:spns:liststringThe list of SPNs by which this provider is identified if the Kerberos SPN handling mode is set to list.
kerberos:spns:modeall
list
The way SPNs are matched to this provider. All handles any SPN recognized by the keytab, while list handles only the specified list of SPNs.
kerberos:strip_realm1 or 01: The REALM portion will be stripped from the User Principal Name when constructing the username and (optionally) the display name.
0: The REALM portion will not be stripped from the User Principal Name.
kerberos:users:modeall
list
regex
The way users are matched to this provider. All handles any valid authentication attempt, list handles only the specified list of users, and regex handles only users who match the specified regular expression.
kerberos:users:regexstringThe Perl-compatible regular expression that user principals must match to be considered part of this provider if the Kerberos user handling mode is set to regex.
ldap:agent1 or 01: A connection agent is being used to enable communication.
0: The LDAP server and the B Series Appliance communicate directly.
ldap:agent:password***The readable date and time of the first date to be included in the report.
ldap:binding:anonymous1 or 01: Anonymous binding is being used.
0: A bind username and password are required.
ldap:binding:password***The password used for binding.
ldap:binding:usernamestringThe username used for binding.
ldap:cache1 or 01: LDAP object cache is enabled.
0: LDAP object cache is disabled.
ldap:cert<data>
or blank
Indicates that a certificate has been uploaded or changed. Only the value <data> will be displayed.
ldap:display_namestringThe set of LDAP attributes used to populate group display names.
ldap:display_querystringThe LDAP query used to determine which users and groups to display when browsing via group policies.
ldap:encryptionnone
ssl
starttls
The type of security encryption to use. None indicates non-encrypted LDAP, ssl indicates LDAPS, and starttls indicates LDAP with TLS.
ldap:groups:objectsstringThe LDAP objectClasses that are considered valid groups.
ldap:groups:recursive1 or 01: Perform recursive group lookup, searching for group members of groups until no results are returned.
0: Execute only one group lookup query.
ldap:groups:search_basestringThe distinguishedName at which to start searching for groups.
ldap:groups:unique_idstringThe set of LDAP attributes used to uniquely identify groups in the LDAP server.
ldap:groups:user_to_group_relationshipstringThe mapping of LDAP attributes used to determine a user's group memberships.
ldap:hoststringThe hostname of the LDAP server.
ldap:portstringThe port through which to connect to the LDAP server.
ldap:user_display_querystringThe LDAP query used to define which results are displayed when adding users to a group policy.
ldap:users:objectsstringThe LDAP objectClasses that are considered valid users.
ldap:users:querystringThe LDAP query used to map a particular username to an LDAP user object.
ldap:users:search_basestringThe distinguishedName at which to start searching for users.
ldap:users:user_idstringThe set of LDAP attributes used to uniquely identify users in the LDAP server.
provider:idstringThe unique identifier of the provider to which this setting applies.
provider:namestringThe name of the provider to which this setting applies.
radius:hoststringThe hostname of the RADIUS server.
radius:portstringThe port through which to connect to the RADIUS server.
radius:shared_secret***The shared secret to use in connecting to the RADIUS server.
radius:timeoutintegerThe number of seconds allowed to elapse before the RADIUS server has timed out.
radius:users:modeall
list
The way users are matched to this provider. All handles any valid authentication attempt, and list handles only the specified list of users.
saml:associated_domainsstringAssociated SAML email domains.
saml:emailstringThe user attribute to use as the email address.
saml:groups:listdelimited stringThe list of groups associated with the identity provider. The delimiter is set in the user interface.
saml:groups:lookupstringThe name of the attribute that contains the names of groups to which users should belong.
saml:idp:certstringThe identity provider's certificate. When you first create a SAML security provider, this value will be metadata. Once you have uploaded the identity provider's metadata, the value will appear in the form of provider_cert.<provider_id>.server_cert.cert.
saml:idp:entity_idstringThe unique identifier for the identity provider you are using.
saml:idp:login_urlstringThe URL where you are automatically redirected to sign into BeyondTrust using SAML.
saml:idp:request_bindstringEither urn:oasis:names:tc:SAML:2.0:bindings:HTTP-Redirect or urn:oasis:names:tc:SAML:2.0:bindings:HTTP-POST.
saml:name_id_formatstringWill always be urn:oasis:names:tc:SAML:2.0:nameid-format:persistent.
saml:sp:entity_idstringThe URL of your public site. This uniquely identifies the service provider.
saml:user_namestringThe user attribute to use as the username.
users:liststringThe list of users allowed to authenticate against this provider to access your BeyondTrust software.
sync_display_name1 or 01: Every time a user logs in, their display name should be synchronized with the available remote information.
0: A user's display name should be synchronized with the available remote information only the first time the user logs in.
scim:emailstringThe user attribute to use as the email address.
scim:user_namestringThe user attribute to use as the username.
scim:private_display_namestringThe user attribute to use as the private display name.
scim:public_display_namestringThe user attribute to use as the public display name.
scim:vendorstringThe SCIM system being used for privileged identity management, such as SailPoint.
scim:users:query_ididThe {id} element used for simple GET queries for users.
scim:group:query_ididThe {id} element used for simple GET queries for groups.
scim:users:id_case_insensitiveEnabled
Disabled
The attribute indicating whether the case is sensitive or insensitive. The value is Disabled by default.
scim:users:user_idstringThe set of SCIM attributes used to uniquely identify users.
scim:users:provisionbooleanBoolean denoting if the provisioning of a user is enforced.
vendor:durationintegerThe frequency with which notifications will be sent to the PRA User. The unit is in hours, with a minimum of 1 hour and a maximum of 168 hours (1 week).
vendor:duration_enabled1 or 01: An email is sent to the PRA User if there are users in the "Users Awaiting Action" table.
0:No emails are sent if there are users in the "Users Awaiting Action" table.
vendor:last_notifiedstringThe last date and time a "Users Awaiting Action" email was sent to the PRA User.

Session policy

These fields apply to the session_policy_added, session_policy_changed, and session_policy_removed events. Session policy events also include the Support permissions fields.

FieldValueExplanation
automatic_privacy_screen0 or 11:The privacy screen will be displayed.
0: The privacy screen will not be displayed.
code_namestringThe code name of this session policy.
descriptionstringThe description of this session policy.
idstringThe unique identifier of this session policy.
namestringThe name of this session policy.

Setting

These fields apply to the setting_added and setting_changed events.

FieldValueExplanation
alert_interval
integerThe number of seconds between sending the last alert and sending another failure notification email, as long as failover synchronization has not yet occurred.
alerts:daily
1 or 01: Send a daily email notification to verify that communication is working correctly.
0: No daily communications will be sent.
alerts:email
stringThe list of email addresses to which to send email alerts.
api
1 or 01: The API is enabled.
0: The API is disabled.
api:http
1 or 01: The API is enabled over HTTP.
0: The API is enabled only over HTTPS.
app-switcher:connector-list
stringThe App Switcher connector list.
auto
1 or 01: If the primary B Series Appliance goes down, automatic failover will occur.
0: If the primary B Series Appliance goes down, automatic failover will not occur.
backup_enabled
1 or 01: Automatic data synchronization between a primary and a backup B Series Appliance is enabled.
0: Automatic data synchronization is disabled.
bandwidth
integerThe maximum number of bytes per second that should be used for data synchronization between a primary and a backup B Series Appliance.
become_backup
noneGiven when the failover role is changed to backup by a user.
become_primary
noneGiven when the failover role is changed to primary by a user.
connection_test_ips
comma-delimited listThe list of IP addresses for the backup B Series Appliance to use to test network connectivity before failing over.
email:auth_type
none
oauth
userpass
The type of authentication used by the SMTP server.
email:encryption
none
ssl
tls
The type of encryption used for the SMTP email server.
email:host
stringThe SMTP server through which to send emails.
email:oauth_provider_id
stringThe OAuth provider ID. Only used with OAuth authentication.
email:password
***Indicates if the password has changed. The actual string is never supplied.
email:port
integerThe SMTP server port through which to connect.
email:user
stringThe username used to authenticate with the SMTP server.
external_key:crm_url
stringThe URL configured to use in conjunction with the custom link button in the access console.
fedramp:behavior_rules_accepted
1 or 01: An admin has accepted the FedRAMP behavior agreement.
0: The FedRAMP behavior agreement has not been accepted.
file_store:listing
1 or 01: Show the file store at the /file directory.
0: Do not allow web access to the file store.
icap:url
stringURL to use when submitting files to an ICAP service during a session file transfer.
ips
comma-delimited listIP addresses shared between the primary B Series Appliance and the backup B Series Appliance.
localization:chat_translator_profile_name
stringThe chat translator profile name.
localization:chat_translator_status
stringThe status of the chat translator.
localization:chat_translator_languages
stringThe chat translator languages.
localization:default_language
stringThe default language for the site.
localization:real_time_chat_translation_provider
stringA selected realtime chat transcription provider.
localization:aws_api_key
stringThe AWS realtime translation API key.
localization:aws_api_secret
stringThe AWS realtime translation API secret.
log_full_run_as_command
1 or 01: The full run as command will be logged.
0: Do not log the full run as command.
login_restrictions:list
stringA list of IPs which should be allowed or denied access to the /login and /api interfaces. This may also be combined with access console login restrictions.
login_restrictions:list_type
allow_all
allow_list
deny_list
Whether to allow all IP addresses, to allow only specified IP addresses, or to deny specified IP addresses access to the /login and /api interfaces of the B Series Appliance. This may also be combined with access console login restrictions.
login_restrictions:rep
always
first_authentication
never
Whether log into the access console is restricted to allowed networks every time, only the first time, or never.
login_restrictions:web
always
none
Whether access to /login, /api, and the access console is restricted or not. This is combined with the other login restriction messages above.
login_restrictions:web:ports:allow
stringA list of ports that are allowed to access the /login interface.
login_restrictions:web:ports:deny
stringA list of ports that are not allowed to access the /login interface.
networks:list
stringA list of IP addresses which should be allowed or denied.
networks:type
allow_all
allow_list
deny_list
Whether to allow all IP addresses, to allow only specified IP addresses, or to deny specified IP addresses access to the /appliance administrative interface of the B Series Appliance.
outbound_event:email_retry_duration
integerThe number of seconds between each email retry attempt.
p2p
1 or 01: Peer-to-peer connections are enabled.
0: Peer-to-peer connections are disabled.
p2p_stunserver_address
stun.bt3ng.com
undefined
If the BeyondTrust hosted peer-to-peer server is used, the value is stun.bt3ng.com. If the B Series Appliance is used, the value is undefined.
p2p_ui_state
0, 1, or 20: Peer-to-peer is disabled.
1: The BeyondTrust hosted peer-to-peer server is being used.
2: The B Series Appliance is being used as the peer-to-peer server.
ports:http
comma-delimited listA list of ports that will respond to HTTP traffic.
ports:https
comma-delimited listA list of ports that will respond to HTTPS traffic.
ports:management:allowed
comma-delimited listA list of ports that are allowed to access the /appliance interface.
ports:management:denied
comma-delimited listA list of ports that are not allowed to access the /appliance interface.
ports:management:http
integerThe port to use when generating a URL that should be viewed over HTTP.
ports:management:https
integerThe port to use when generating a URL that should be viewed over HTTPS.
pre_login_agreement:enabled
1 or 01: The /login prerequisite login agreement has been enabled.
0: The /login prerequisite login agreement has been disabled.
probe:max_timeout
integerThe number of seconds between the first failure to reach the primary B Series Appliance and fail over to the backup B Series Appliance.
relationship_broken
array of semicolon-separated valuesGenerated when failover relationship is broken.
Values:
  • this:hostname=hostname where entry is made
  • this:port=port used by current host
  • peer:hostname=hostname of peer in failover relationship
  • peer:port=port of peer in failover_relationship
relationship_established
array of semicolon-separated valuesGenerated when failover is established.
Values:
  • this:hostname=hostname where entry is made
  • this:port=port used by current host
  • peer:hostname=hostname of peer in failover relationship
  • peer:port=port of peer in failover_relationship
rep:allow_rep_cli
1 or 01: The rep console will allow use of the CLI tool.
0: Do not allow use of the CLI tool.
rep:custom_link
stringThe URL that will appear as a button in the access console during a support session.
rep:dashboard:monitor
disabled
enabled:only_rep_console
Whether team managers and leads are disallowed to monitor team members or are allowed to view team members' access consoles..
rep:dashboard:transfer
1 or 01: Allow team managers and team leads to take over team members' sessions.
0: Do not allow transferring of team members' sessions.
rep:mobile
1 or 01: Mobile access consoles are allowed to connect.
0: Mobile access consoles are not allowed to connect.
rep:history:enabled
1 or 01: Enable team chat history.
0: Disable team chat history.
rep:history:hours
integer from 1 to 24Hours of team chat history to replay.
rep:private_queue_exit_check
1 or 01: A user cannot log out or quit the access console until their personal queue is empty.
0: A user can log out or quit the access console with sessions still in their personal queue.
rep:saved_logins
1 or 01: Allow users to have the access console remember their credentials.
0: Do not allow the access console to remember representatives' credentials.
rep_console_settings_applied
integerAn incrementing number indicating when managed access console settings have been applied to all representatives.
reporting:history_limit
integerThe number of days to keep logging information, expressed as seconds.
security:default_auth_mechanism
fido2
gssapi
password
saml
The default selection for the authentication dropdown in the rep console.
service.syslog.remote.format
syslog
bsd
bsd_no_ts
tls
syslog: The syslog data format is RFC 5424 compliant.
bsd: The syslog data format is legacy BSD format.
bsd_no_ts: The syslog data format is legacy BSD format without timestamp.tls: The syslog data format is Syslog over TLS (RFC 5425).
slac:password
stringThe password for inter-appliance communication. Appliances that wish to communicate with each other must have the same password.
ssl:certificate_verify
1 or 01: Validate the SSL certificate chain for security.
0: Do not validate the SSL certificate chain.
support:clipboard_sync_mode
disabled
manual:rep_to_cust
manual:both_directions
auto:both_directions
disabled: The user cannot synchronize the clipboards with the customer's clipboard during a support session.
manual:rep_to_cust: The user can send the clipboard manually to the customer's clipboard during a session.
manual:both_directions: The user can send the clipboard to the customer's clipboard during a session, and the customer can send their clipboard to the user manually.
auto:both_directions: The clipboard is sent automatically from the user to the customer, and from the customer to the user.
support:inactive_rep:timeout
integerThe number of seconds with no session activity before a user is removed from a specific session.
support:jump_client:active_interval
integerThe number of seconds to wait between each Jump Client statistics update.
support:jump_client:allow_wake_on_lan
1 or 01: Users can attempt to wake up a Jump Client.
0: Users cannot attempt to wake up Jump Clients.
support:jump_client:concurrent_upgrades
integerThe maximum number of Jump Clients whose statistics can be updated simultaneously.
support:jump_client:removal_behavior
uninstalled
remove
uninstalled: A Jump Client deleted by an end user remains visible in the access console.
remove: A Jump Client deleted by an end user is removed from the access console.
support:jump_client:stats
comma-delimited listThe statistics to collect from each Jump Client. Currently recognized statistics include pss_os (operating system), pss_ut (uptime), pss_cpu (central processing unit usage), pss_cu (console user), pss_fd (disk usage), and pss_tn (screen thumbnail image).
support:jump_client:stats:active_interval
integerThe number of seconds to wait between active Jump Client statistics updates.
support:jump_client:ticket_system:ticket_id_sensitive
1 or 01: The ticket ID is treated as sensitive information.
0: The ticket ID is not treated as sensitive information.
support:jump_item:simultaneous_jump_behavior
join
disallow
join: Multiple users can Jump to the same Jump Item simultaneously.
disallow: Only one user at a time can Jump to a Jump Item without an invitation from the first user to share the session.
support:jump_item:simultaneous_jump_behavior_applies_to_copies
1 or 01: The simultaneous_jump_behavior also applies to copied pinned clients. Does not apply if simultaneous_jump_behavior is disabled.
0: The simultaneous_jump_behavior does not apply to copied pinned clients.
support:jump_item:simultaneous_rdp_jump_behavior
start
disallow
start: Multiple users can Jump to the same RDP Jump Item simultaneously.
disallow: Only one user at a time can Jump to an RDP Jump Item without an invitation from the first user to share the session.
support:recordings:command_shell
1 or 01: Record a video of command shells.
0: Do not record command shells.
support:recordings:command_shell:resolution
320x240
640x480
800x600
1024x768
1280x1024
The resolution selected to convert command shell recordings when viewing or downloading them.
support:recordings:screen_sharing
1 or 01: Record a video of screen sharing during sessions.
0: Do not record sessions.
support:recordings:screen_sharing:resolution
320x240
640x480
800x600
1024x768
1280x1024
The resolution to which to convert session recordings when viewing or downloading.
support:recordings:show_my_screen
1 or 01: Record a video of Show My Screen sessions.
0: Do not record Show My Screen sessions.
support:special_actions:builtins
1 or 01: Show the built-in special actions in support sessions.
0: Hide the built-in special actions in support sessions.
support:system_info:auto_log
1 or 01: Automatically log the remote computer's system information at the beginning of a session.
0: Do not log system information.
support:system_info:auto_log:mobile
Standard
Full
Standard: Provide standard logging for mobile platforms.
Full: Provide extended logging for mobile platforms. This option is the Extended dropdown option in the user interface.
sync_interval
minute
hour
day
week
minute=Every x minutes
hour=Every x hours
day=Every day at x time
week=Once a week at x day and y time.
sync_interval:days
integer from 1 to 7If sync_interval = week, it denotes the day of the week on which the auto data sync will occur. 1 = Sunday, 7 = Saturday.
sync_interval:hours
integer from 1 to 24If sync_interval = week or day, then this value tells the hour of the day that the data sync will run. If sync_interval = hour, then it tells how many hours will be between every data sync (Every x hours).
sync_interval:minutes
integer from 1 to 60If sync_interval = week or day, then this value tells the minute of the hour that the data sync will run. If sync_interval = minute, then it tells how many minutes will be between every data sync (Every x minutes).
syslog
stringThe address of the remote syslog server to which to send messages.
system.auth.local.failed-login-lockout-duration
integerThe number of minutes an /appliance account is locked out after the maximum number of failed logins is exceeded. If 0, the account is locked out until an administrator unlocks the account.
system.auth.local.failed-login-lockout-threshold
integerThe number of failed login attempts after which the /appliance user will be locked out of their account. If 0, the user will never be locked out.
system.auth.local.password-expire-duration
integerThe number of days after which an /appliance user's password expires. If 0, the password never expires.
system.auth.local.password-history-count
integerThe number of prior passwords that an /appliance user cannot use when changing their password. If 0, there is no restriction.
system.pre-login-agreement.enabled
1 or blank1: The /appliance prerequisite login agreement has been enabled.
system.pre-login-agreement.text
stringThe text of the login agreement that user must accept before accessing the /appliance administrative interface.
system.pre-login-agreement.title
stringThe title of the login agreement that user must accept before accessing the /appliance administrative interface.
timezone
stringThe time zone in which this B Series Appliance renders system times.
users:idle_timeout
integerThe maximum number of seconds a access console can be idle before that user will be logged out.
users:idle_timeout_applies_to_tunnels
1 or 0If 1, then protocol tunnel based sessions are considered idle if no tools are connected to the open tunnel.
users:lockout_duration
integerThe length of time in minutes a locked-out user must wait before being allowed to reattempt login. 0 indicates that an admin must unlock the account.
users:max_failed_logins
integerThe number of failed login attempts after which the account will be locked out.
users:passwordless_fido2_auth:enabled
1 or 01Users can register and log in with FIDO2 authenticators instead of a password.
2 FIDO2 authentication is disabled and cannot be used.
users:passwords:complex
1 or 01: Require complex passwords.
0: Do not require complex passwords.
users:passwords:default_expiration
integerThe default number of days a password can be used before it expires and must be reset.
users:passwords:minimum_length
integerThe minimum number of characters required for a password.
users:passwords:reset
1 or 01: Users can reset forgotten passwords by correctly answering a security question.
0: Users cannot reset forgotten passwords.
users:terminate_if_user_logged_in
1 or 0If a user attempts to log into the access console using an account that is already in use in another access console:
1: Terminate the existing connection so that the new user can log in.
0: Maintain the existing connection and do not allow the new user to log in.

Shared Jump Group

These fields apply to the shared_jump_group_added, shared_jump_group_changed, and shared_jump_group_removed events.

FieldValueExplanation
code_namestringThe code name of this Jump Group.
commentsstringAny comments associated with this Jump Group.
ecm_groupstringThe ID of the ECM Group assigned to the group.
idstringThe unique identifier of the Jump Group.
namestringThe name of the Jump Group.

SNMP

These fields apply to the SNMP_changed event.

FieldValueExplanation
snmpv2 enabled1 or 01: The B Series Appliance has SNMP_v2 Server enabled.
0: The B Series Appliance has SNMP_v2 Server disabled.
snmp_v2_syslocationstringThe location of this B Series Appliance for the SNMP MIB.
snmp_v2_rocommunitystringThe community name the SNMPv2 Server should respond to.
snmp_v2_netACLstringThe list of IP addresses allowed to access SNMP on this B Series Appliance.

SSH account

These fields apply to the ssh_account_added, ssh_account_changed, and ssh_account_removed events.

FieldValueExplanation
key_sizestringThe key size.
key_hashstringThe key hash.
key_formatstringThe key format.
key_commentstringThe key comment.
public_keystringThe public key.
public_cert_public_keystringThe public certificate public key.
public_cert_signing_castringThe public certificate signing ca.
public_cert_valid_fromstringThe public certificate initial date.
public_cert_valid_tostringThe public certificate expiration date.

Support permissions

These fields apply to session policy and custom session policy events.

FieldValueExplanation
support:permissions:allow_pinned_clients
yes
no
Whether this session policy may be applied to Jump Clients or not.
support:permissions:allow_rep_invite
yes
no
Whether this session policy may be applied to access invites or not.
support:permissions:allow_users
yes
no
Whether this session policy may be applied to users or not.
support:permissions:canned_scripts
allow
deny
not_defined
Whether this policy's permission to run canned scripts is allowed, denied, or not defined.
support:permissions:command_shell
allow
deny
not_defined
Whether this policy's permission to use the command shell is allowed, denied, or not defined.
support:permissions:file_transfers:cust
any_path
list of paths
not_defined
Whether the user is allowed to access any path on the remote computer's file system for the purpose of file transfer, only specified paths, or not defined.
support:permissions:file_transfers:download
allow
deny
not_defined
Whether this policy's permission to download files using file transfer is allowed, denied, or not defined.
support:permissions:file_transfers:rep
any_path
list of paths
not_defined
Whether the user is allowed to access any path on their local file system for the purpose of file transfer, only specified paths, or not defined.
support:permissions:file_transfers:upload
allow
deny
not_defined
Whether this policy's permission to upload files using file transfer is allowed, denied, or not defined.
support:permissions:registry_access
allow
deny
not_defined
Whether this policy's permission to access the remote registry editor is allowed, denied, or not defined.
support:permissions:screen_sharing
view_and_control
view_only
not_allowed
not_defined
Whether this policy's permission to screen share allows view and control, allows view only, is denied, or is not defined.
support:permissions:screen_sharing:automatic_privacy_screen_request
0 or 1 
support:permissions:screen_sharing:annotations
allow
deny
not_defined
Whether this policy's permission to use annotations is allowed, denied, or not defined.
support:permissions:screen_sharing:privacy_mode
input_only
privacy_screen,input
none
not_defined
Whether this policy's allowed customer restrictions are set to mouse and keyboard only; display, mouse, and keyboard; none; or not defined.
support:permissions:system_info
allow
deny
not_defined
Whether this policy's system information permission is set to allowed, denied, or not defined.
support:permissions:system_info:actions
allow
deny
not_defined
Whether this policy's system information actions permission is set to allowed, denied, or not defined.

Support team

These fields apply to the support_team_added, support_team_changed, and support_team_removed events.

FieldValueExplanation
code_namestringThe code name of this team.
commentsstringAny comments associated with this team.
idstringThe unique identifier of the team.
namestringThe name of the team.

Support team member

These fields apply to the support_team_member_added, support_team_member_changed, and support_team_member_removed events.

FieldValueExplanation
rolemember
lead
manager
The role this user plays in the team.
team:idstringThe unique identifier of the team to which this user belongs.
team:namestringThe name of the team to which this user belongs.
user:idstringThe unique identifier of the user being added to or removed from this team.
user:usernamestringThe name of the user being added to or removed from this team.

Syslog server

These fields apply to the syslog_server_changed event.

FieldValueExplanation
message_formatRFC 5424 compliant
Legacy BSD format
Legacy BSD format without timestamp
Syslog over TLS (RFC 5425)
The data format for syslog event notification messages.
syslog_serverscomma-delimited listA list of IP addresses that receive syslog messages from this B Series Appliance.

/appliance user

These fields apply to the user_added, user_changed, and user_removed events. These fields apply to users added to the /appliance interface.

FieldValueExplanation
displaynamestringThe display name of this user.
failed_login_attemptsintegerThe number of consecutive failed attempts to log into this account.
lockout_releasedate or 0The readable date and time that an administrator reset the number of failed login attempts back to zero. 0 indicates that the number of failed login attempts has not just been reset.
password***Indicates if the user's password has been changed.
password_changed_datedateThe readable date and time that the password was last changed.
password_force_reset1 or 01: The user must create a new password upon next login.
0: The password need not be changed.
usernamestringThe username the user last used to authenticate to the BeyondTrust /appliance interface. Not necessarily unique.

/login user

These fields apply to the user_added, user_changed, and user_removed events. User events also include the Permission fields. These fields apply to users added to the /login interface.

FieldValueExplanation
account:createdUnix timestampThe date and time this user account was created.
account:disabled1 or 01: This local user account is disabled.
0: This local user account is active.
account:email:addressstringThe email address set for notifications.
account:email:localestringValues are the language abbreviations (e.g. en-us for English) used with emails.
account:expirationUnix timestamp
never
The date and time this local user account will expire, if ever.
account:failed_loginsintegerThe number of consecutive failed attempts to log into this local account.
commentsstringAny comments associated with this user.
external_idstringAn internal representation of a remote user's identifying information, such as an LDAP attribute, RADIUS username, or Kerberos principal name.
idstringThe unique identifier for this user.
idle_timeoutinteger
site_wide_setting
The maximum number of seconds this representative can be idle within the access console before being logged out. The site_wide_setting option defaults to the timeout set on the Management > Security page. If no timeout, uses none.
login_code:enabled1 or 01: The user must enter an emailed login code to log in.
0: The user may log in without an emailed login code.
login_schedule:enabled1 or 01: The user is disallowed to log into the access console outside of the set schedule.
0: The user may log into the access console at any time.
login_schedule:force_logout1 or 01: The user is automatically logged out of the access console at the end of the scheduled time.
0: The user is not forced to log out of the access console at the end of the scheduled time.
login_schedule:timezonestringThe timezone for which the login schedule is set.
password***Indicates if the local user's password has been changed by an administrator.
password:expirationUnix timestampThe date and time the local user's password will expire, if ever.
password:reset1 or 01: The local user must create a new password upon next login.
0: The password need not be changed.
password:will_expire1 or 01: The local user's password is set to expire on a certain date.
0: The local user's password has no expiration set.
provider:idstringThe unique identifier of the security provider against which this user last authenticated, or 1 for a local user.
provider:namestringThe name of the security provider against which this user last authenticated.
security_answer***Indicates if the local user's security answer was changed by an administrator.
security_questionstringThe security question the local user can answer to reset their password.
two_factor_auth:required1 or 01: This user is required to use two-factor authentication.
0: This user is not required to use two-factor authentication.
usernamestringThe username the user last used to authenticate to BeyondTrust. Not necessarily unique.

User account report generated

These fields apply to the user_account_report_generated event.

FieldValueExplanation
report_typeall
local
security_provider
Whether the downloaded report was for all users, only local users, or only a security provider.

User session policy

These fields apply to the user_session_policy_added and user_session_policy_removed events.

FieldValueExplanation
session_policy:namestringThe name of the session policy associated with this user.
user:idstringThe unique identifier of the user with whom the session policy is associated.
user:usernamestringThe username of the user with whom the session policy is associated.

Vault account password rotation

These fields apply to the vault_account_password_rotation event.

FieldValueExplanation
reasonstringThe reason for the rotation.
statussuccess
failure
Whether the rotation attempt succeeded or failed.
accountstringThe account username rotated.

Windows service

These fields apply to the windows_service_removed and windows_service_changed events.

FieldValueExplanation
account_idnumberThe unique identifier of the account.
display_namestringThe display name of the Windows service.
endpoint_idnumberThe unique identifier of the endpoint.
namestringThe name of the Windows service.
restart_on_rotation1 or 01: Enables the automatic rotation for this account.
0: Disables the automatic rotation for this account.

©2003-2025 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.