Setting Fields
These fields apply to the setting_added and setting_changed events.
Field | Value | Explanation |
---|---|---|
alert_interval |
integer |
The 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 0 |
1: Send a daily email notification to verify that communication is working correctly.
|
alerts:email |
string |
The list of email addresses to which to send email alerts. |
api |
1 or 0 |
1: The API is enabled.
|
api:http |
1 or 0 |
1: The API is enabled over HTTP.
|
app-switcher:connector-list | string | The App Switcher connector list. |
auto |
1 or 0 |
1: If the primary B Series Appliance goes down, automatic failover will occur.
|
backup_enabled |
1 or 0 |
1: Automatic data synchronization between a primary and a backup B Series Appliance is enabled.
|
bandwidth |
integer |
The maximum number of bytes per second that should be used for data synchronization between a primary and a backup B Series Appliance. |
become_backup |
none |
Given when the failover role is changed to backup by a user. |
become_primary |
none |
Given when the failover role is changed to primary by a user. |
connection_test_ips |
comma- |
The list of IP addresses for the backup B Series Appliance to use to test network connectivity before failing over. |
email:auth_type |
none
|
The type of authentication used by the SMTP server. |
email:encryption |
none
|
The type of encryption used for the SMTP email server. |
email:host |
string |
The SMTP server through which to send emails. |
email:oauth_provider_id |
string |
The OAuth provider ID. Only used with OAuth authentication. |
email:password |
* * * * |
Indicates if the password has changed. The actual string is never supplied. |
email:port |
integer |
The SMTP server port through which to connect. |
email:user |
string |
The username used to authenticate with the SMTP server. |
external_key:crm_url |
string |
The URL configured to use in conjunction with the custom link button in the access console. |
fedramp:behavior_rules_accepted |
1 or 0 |
1: An admin has accepted the FedRAMP behavior agreement. |
file_store:listing |
1 or 0 |
1: Show the file store at the /file directory.
|
icap:url |
string |
URL to use when submitting files to an ICAP service during a session file transfer. |
ips |
comma- |
IP addresses shared between the primary B Series Appliance and the backup B Series Appliance. |
localization:chat_translator_profile_name | string | The chat translator profile name. |
localization:chat_translator_status | string | The status of the chat translator. |
localization:chat_translator_languages | string | The chat translator languages. |
localization:default_language | string | The default language for the site. |
localization:real_time_chat_translation_provider | string | A selected realtime chat transcription provider. |
localization:aws_api_key | string | The AWS realtime translation API key. |
localization:aws_api_secret | strubg | The AWS realtime translation API secret. |
log_full_run_as_command |
1 or 0 |
1: The full run as command will be logged. |
login_restrictions:list |
string |
A 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 |
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 |
Whether log into the access console is restricted to allowed networks every time, only the first time, or never. |
login_restrictions:web |
always |
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 |
string |
A list of ports that are allowed to access the /login interface. |
login_restrictions:web:ports:deny |
string |
A list of ports that are not allowed to access the /login interface. |
networks:list |
string |
A list of IP addresses which should be allowed or denied. |
networks:type |
allow_all
|
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 |
integer |
The number of seconds between each email retry attempt. |
p2p | 1 or 0 | 1: Peer-to-peer connections are enabled. 0: Peer-to-peer connections are disabled. |
p2p_stunserver_address |
stun.bt3ng.com
|
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 2 |
0: Peer-to-peer is disabled. |
ports:http |
comma-delimited list |
A list of ports that will respond to HTTP traffic. |
ports:https |
comma-delimited list |
A list of ports that will respond to HTTPS traffic. |
ports:management:allowed |
comma-delimited list |
A list of ports that are allowed to access the /appliance interface. |
ports:management:denied |
comma-delimited list |
A list of ports that are not allowed to access the /appliance interface. |
ports:management:http |
integer |
The port to use when generating a URL that should be viewed over HTTP. |
ports:management:https |
integer |
The port to use when generating a URL that should be viewed over HTTPS. |
pre_login_agreement:enabled |
1 or 0 |
1: The /login prerequisite login agreement has been enabled. |
probe:max_timeout |
integer |
The 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 values |
Generated when failover relationship is broken. Values:
|
relationship_established |
array of semicolon separated values |
Generated when failover is established. Values:
|
rep:allow_rep_cli |
1 or 0 |
1: The rep console will allow use of the CLI tool. |
rep:custom_link |
string |
The URL that will appear as a button in the access console during a support session. |
rep:dashboard:monitor |
disabled |
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 0 |
1: Allow team managers and team leads to take over team members' sessions.
|
rep:mobile |
1 or 0 |
1: Mobile access consoles are allowed to connect. 0: Mobile access consoles are not allowed to connect. |
rep:history:enabled |
1 or 0 |
1: Enable team chat history. |
rep:history:hours |
integer from 1 to 24 |
Hours of team chat history to replay. |
rep:private_queue_exit_check |
1 or 0 |
1: A user cannot log out or quit the access console until their personal queue is empty. |
rep:saved_logins |
1 or 0 |
1: Allow users to have the access console remember their credentials.
|
rep_console_settings_applied |
integer |
An incrementing number indicating when managed access console settings have been applied to all representatives. |
reporting:history_limit |
integer |
The number of days to keep logging information, expressed as seconds. |
security:default_auth_mechanism |
fido2 |
The default selection for the authentication dropdown in the rep console. |
service.syslog.remote.format |
syslog |
syslog: The syslog data format is RFC 5424 compliant. |
slac:password | string | The password for inter-appliance communication. Appliances that wish to communicate with each other must have the same password. |
ssl:certificate_verify |
1 or 0 |
1: Validate the SSL certificate chain for security.
|
support:clipboard_sync_mode |
disabled |
disabled: The user cannot synchronize the clipboards with the customer's clipboard during a support session.
|
support:inactive_rep:timeout |
integer |
The number of seconds with no session activity before a user is removed from a specific session. |
support:jump_client:active_interval |
integer |
The number of seconds to wait between each Jump Client statistics update. |
support:jump_client:allow_wake_on_lan |
1 or 0 |
1: Users can attempt to wake up a Jump Client. |
support:jump_client:concurrent_upgrades |
integer |
The maximum number of Jump Clients whose statistics can be updated simultaneously. |
support:jump_client:removal_behavior |
uninstalled |
uninstalled: A Jump Client deleted by an end user remains visible in the access console. |
support:jump_client:stats |
comma- |
The 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 |
integer |
The number of seconds to wait between active Jump Client statistics updates. |
support:jump_client:ticket_system:ticket_id_sensitive |
1 or 0 |
1: The ticket ID is treated as sensitive information. |
support:jump_item:simultaneous_jump_behavior |
join |
join: Multiple users can Jump to the same Jump Item simultaneously. |
support:jump_item:simultaneous_jump_behavior_applies_to_copies | 1 or 0 | 1: 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 |
start: Multiple users can Jump to the same RDP Jump Item simultaneously. |
support:recordings:command_shell |
1 or 0 |
1: Record a video of command shells.
|
support:recordings:command_shell:resolution |
320x240
|
The resolution selected to convert command shell recordings when viewing or downloading them. |
support:recordings:screen_sharing |
1 or 0 |
1: Record a video of screen sharing during sessions. |
support:recordings:screen_sharing:resolution |
320x240
|
The resolution to which to convert session recordings when viewing or downloading. |
support:recordings:show_my_screen |
1 or 0 |
1: Record a video of Show My Screen sessions. |
support:special_actions:builtins |
1 or 0 |
1: Show the built-in special actions in support sessions. |
support:system_info:auto_log |
1 or 0 |
1: Automatically log the remote computer's system information at the beginning of a session.
|
support:system_info:auto_log:mobile |
Standard
|
Standard: Provide standard logging for mobile platforms. |
sync_interval |
minute |
minute=Every x minutes |
sync_interval:days |
integer from 1 to 7 |
If 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 24 |
If 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 60 |
If 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 |
string |
The address of the remote syslog server to which to send messages. |
system.auth.local.failed-login-lockout-duration |
integer |
The 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 |
integer |
The 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 |
integer |
The number of days after which an /appliance user's password expires. If 0, the password never expires. |
system.auth.local.password-history-count |
integer |
The 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 blank |
1: The /appliance prerequisite login agreement has been enabled. |
system.pre-login-agreement.text |
string |
The text of the login agreement that user must accept before accessing the /appliance administrative interface. |
system.pre-login-agreement.title |
string |
The title of the login agreement that user must accept before accessing the /appliance administrative interface. |
timezone |
string |
The time zone in which this B Series Appliance renders system times. |
users:idle_timeout |
integer |
The 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 0 |
If 1, then protocol tunnel based sessions are considered idle if no tools are connected to the open tunnel. |
users:lockout_duration |
integer |
The 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 |
integer |
The number of failed login attempts after which the account will be locked out. |
users:passwordless_fido2_auth:enabled |
1 or 0 |
1Users can register and log in with FIDO2 authenticators instead of a password. |
users:passwords:complex |
1 or 0 |
1: Require complex passwords. |
users:passwords:default_expiration |
integer |
The default number of days a password can be used before it expires and must be reset. |
users:passwords:minimum_length |
integer |
The minimum number of characters required for a password. |
users:passwords:reset |
1 or 0 |
1: Users can reset forgotten passwords by correctly answering a security question. |
users:terminate_if_user_logged_in |
1 or 0 |
If a user attempts to log into the access console using an account that is already in use in another access console:
|