Record a Script

Record scripts in FireEyes then upload them to WorldSpace to use them in WorldSpace scans.

To Record a Script:

1. Make Sure You're Connected to the Correct Project

IMPORTANT: Make sure to connect to the correct project before recording the script. How to switch projects. If you record the script then switch projects, you will lose the script and you will need to record it again.

2. Go to the FireEyes Script tab.

3. Go to the Page Where the Script will Start

Navigate to the first page you wish to include in the script. For example, if you are recording a login script, go to the login page.

4. Recommended: Clear Your Browser History, Cache, and Cookies

Sometimes the stored information in your browser can interfere with the proper recording of a script, because the stored information may bypass important steps that you need your script to record. For example, your browser's current session variables or cookies may contain login credentials or other contextual information. Some web pages use this information to serve context-dependent information to users. You need to record the script as if you had never been to the web pages, because that is how WorldSpace will treat the page.

You may not need to clear all of this information from your browser if the script does not depend on these kinds of contextual variables.

5. Start Recording

Select the Record checkbox to turn recording on.

6. Ensure "loadURL" is the First Event in the Script

IMPORTANT: The first line of any script must be the loadURL event, which is the web address of where you want the script to start. If you leave off the loadURL event, WorldSpace won't know where to begin when replaying the script.

To record the loadURL event:

  • Double check to make sure the Record checkbox is checked.
  • Click on the Clear button.
  • Choose "Everything"
  • Click on Clear to confirm.

You can also add the event manually either at the beginning of the process or after recording the script, if you forgot to add it when you first recorded the script. You may also be able to add the loadURL event by refreshing the page in your browser, but that method is less reliable.

7. Perform the Actions You Want to Record

Use your keyboard and/or mouse to perform the actions you wish to record, such as filling out forms, making menu selections, logging in to an account, etc. For example, you could type the word "laptop" in a Search field and select the button that initiates the search. To pause the recording process temporarily select the Freeze button, it will then toggle to Thaw. Select the Thaw button to restart recording again.

8. Stop Recording

Unselect the Record checkbox to stop recording.

9. Verify that the Script Works

To verify that the script performs the steps intended, return to the initial page and its initial state (i.e. log out of the system, empty the shopping cart, etc.), select the Play button (the blue triangle), and confirm that you want the script to play. Learn more about replaying a script continuously or step-by-step.

FireEyes script Play button

10. Upload the Script to WorldSpace

If the script is correct, you may want to upload the script to a WorldSpace Project to save it before performing further analysis.

Notes:

  1. Users should disable the search-on-type feature in Firefox before recording a script, to ensure accurate playback when testing the script in their browser. On a PC: Tools > Options Advanced > General > Search for text when I start typing. On a Mac: Firefox > Preferences > Advanced > General > Search for text when I start typing.
  2. Be aware that having the Record checkbox checked can result in a very large amount of information being recorded by FireEyes - especially when mouse movement events are being recorded.
  3. When the Record checkbox is checked, every event performed on the test site will be recorded, subject to the Project's Event Tracking options. The default options provided by FireEyes should work for most dynamic applications. If you find that your scripts are not replaying correctly, you might need to capture more events, but be selective and capture as little as you need for your script to work.