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. Open the Settings page.

  2. Switch to the Repeaters scripts tab.

  3. Click + New Repeater Script.

  4. In the script dialog box, do the following:

    • In the Name field, enter the name of your script.

    • (Optional) In the Description field, enter some 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.

  5. Click Create to save your script.


Reviewing all scripts

All the created scripts are displayed in the AVAILABLE SCRIPTS section on the Repeater scripts tab.


Editing a script

To edit a specific script, do the following:

  1. Navigate to the Repeater scripts tab in the Settings page.

  2. Click next to the selected script, and then select Edit.

  3. Make the changes to the script in the dialog box, and then click Save.


Deleting a script

To delete a specific script, do the following:

  1. Navigate to the Repeater scripts tab in the Settings page.

  2. Click next to the selected script, and then select Delete.


Loading a script to a 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.

  4. In the dialog box, do the following:

    1. Select the type of the script coverage:

      1. Single global script - applied for the requests that should cover all the target hosts.

      2. 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.

    2. Select the script you want to connect from the dropdown list, then click Update. The uploaded script will then be added to the scan request and executed via the specified Repeater.