These docs are for v1.1. Click to read the latest docs for v1.2.

Managing Repeater Scripts

Repeater Scripts allow you to add, change or compute some part of a scan request before it is dispatched to the target.

Creating a script

To create a script, follow these steps:

  1. In the Repeaters section, click Repeater Scripts in the upper right corner.
  1. In the upper left corner, click + New Repeater Script.
  2. In the script dialog box, do the following:
    • In the Name field, enter the name of your script.
    • (Optional) In the Description field, enter descriptive information about your script.
    • In the Code field, write the script code or paste it from your external editor.

📘

Note

The code example given in this field shows how to write a script for calculating a hash message authentication code (HMAC) value.

Reviewing all scripts

All the created scripts are displayed in the AVAILABLE SCRIPTS section on the Scripts page.

In this section, you can use the following options:

  • To quickly find a certain script, enter its name, description or ID in the search field in the upper right corner.
  • To select the number of scripts that you want to view on one page, select it from the Items per page dropdown list at the bottom.
  • To switch between the pages of the available scripts, use the navigation buttons in the lower right corner.

Editing a script

To edit a specific script, do the following:

  1. Select the script you want to change in the AVAILABLE SCRIPTS section.
  2. Click next to the selected script, and then select Edit.
  1. Add any necessary changes in the script dialog box, then click Update.

Deleting a script

To delete a specific script, do the following:

  1. Select the script you want to delete in the AVAILABLE SCRIPTS section.
  2. Click next to the selected script, and then select Delete.

Loading a script to the repeater

To load a script to a specific Repeater, do the following:

  1. Go to the Repeaters section.
  2. From the list of available Repeaters, select the one you need.
  3. Click next to the selected Repeater, and then select Edit.

In the dialog box, do the following:
a) Select the type of the script coverage:

  • Single global script - applied for the requests that should cover all the target hosts.
  • Host-specific script - applied for the requests that aim at only one specific host.

📘

Note

If you have loaded a local script using the Bright CLI, loading remote scripts from the cloud is disabled automatically.

b) From the dropdown list, select the script you want to connect to, and then click Update.
The uploaded script will be then added to the scan request executed via the specified Repeater.