Skip to main content
Skip table of contents

Example: Keyboard recording

General

With VISULOX keyboard recording it is possible to record the keystrokes entered in an application by a user. Keywords can be defined, that will trigger several options after the keyword has been detected. It is possible to hide the recorded keystrokes in the VISULOX Cockpit, which is very useful, if the user has to enter passwords or other security related information.

If recorded keystrokes are hidden in the VISULOX Cockpit, the keystrokes are hidden in reports generated with this Cockpit as well.

Keep in mind, that keyboard recording does not prevent entering certain commands. Keyboard recording detects keywords and provides some actions after the detection (nearly in real time).

Prerequisites

For this example setup two users have to be registered in VISULOX PORTAL with the following settings:

UserRoleeMailSMSApplicationOther
MasterSupervisor<supervisor>@company.com-VISULOX Cockpit-
MillerUser<user>@company.com-VLX Jump Shell-

Supervisor Master enables and configures keyboard recording.

User Miller logs into VISULOX PORTAL and starts an application to enter some commands.

Configuration of keyboard recording

  1. Supervisor Master creates a new Application Policy in "VLX Cockpit":

    A unique name for the policy must be entered: "POL-APP".

    To use the Application Policy "Enabled" has to be selected.

    A comment for the policy can be entered as well.



  2. Setting the filter:

    Only the "VLX Jump Shell" application will be used for keyboard recording in this example.

    It is also possible to set a filter for the application group, the remote IP address or the access point (not used in this example).



  3. Configuring keyboard control:

    The method for keyboard recording has to be selected: "Record input and detect keywords".

    A script can be selected, which is executed, when a keystroke is detected (not used in this example).

    Activity on detection is set to "Acknowledge on detection".

    And finally a detection message can be entered.

    The Application Policy must be saved before a line item entry can be created.


    There are different ways to use keyboard recording:


    • Example 1: Method: "Record input and detect keywords" / Activity on detection: "Acknowledge on detection"
    • Example 2: Method: "Detect keywords only" / Activity on detection: "Lock on detection"


    Another possibilty for an action on detection is "Keyword detection muted" (not used in these examples).



  4. Creating a keyword detection rule for the policy:


    A keyword detection comment for the keyword can be entered.

    The regexpression of the keyword has to be defined: "badword


Example 1: Miller starts the application and enters the configured keyword

Method: "Record input and detect keywords" / Activity on detection: "Acknowledge on detection"


  1. User Miller starts the "VLX Jump Shell" application from his Workspace:


    The keyword "badword" is detected and the application is locked.

    Miller has to acknowledge the "Keyword detected" box to continue working.

With "Record input and detect keywords" all keystrokes from user Miller are displayed in the VISULOX Cockpit.

Example 2: Miller starts the application and enters the configured keyword

Method: "Detect keywords only" / Activity on detection: "Lock on detection"


  1. User Miller starts the "VLX Jump Shell" application and enters "badword":

    The keyword "badword" is detected and the application is locked.


    If an denied Access Policy is configured with a request script, the "Send Request" button can be displayed next to the "End session" button.

    With "Detect keywords only" only the entered keywords from user Miller are displayed in the Cockpit. Other keystrokes can not be seen.


Keyboard recording check list with additional tests

FeatureExpected behaviourComment
Policy mode: disabled
  • Application Policy has no effect, the next Policy, that matches will be used

Filter settings
  • User/group mask: all registered users are recorded
  • Application mask: all registered applications will be recorded
  • Remote IP mask: all users connecting from the registered IP are recorded
  • Access point mask: all users connecting over the registered access point are recoded

Recording on/off
Keystroke detection
  • Keyboard control disabled: no keystrokes will be recorded
  • Detect keywords only: only keywords are detected, other keystrokes are not displayed in Cockpit
  • Record input and detect keywords: keywords are detected, all keystrokes are recorded and displayed in Cockpit

Activity on detection
  • Keyword detection muted: no message or lock for the user, keyword detection is shown in Cockpit events
  • Acknowledge on detection: screen is locked, the user has to acknowledge
    the "Keyword detected" box to continue working
  • Lock on detection: screen is locked, the user is able to send a
    request to the supervisor, screen remains locked

Detection message
  • Entered message is displayed in the user box and in VISULOX Cockpit events, if a keyword is detected

Line items
  • Active / Disabled: keyword detection is active or disabled
  • Regexpression: the expression for the keyword, that shoul be detected is highly
    configurable to match certain commands or part of commands
  • Script to send notification to the supervisor on keyword detection

Events
  • All actions during recording are displayed in the VISULOX Cockpit

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.