Rapid7 AppSec plugin for Chrome

The Rapid7 AppSec Plugin for Chrome adds useful capabilities like recording your login activities and replaying attacks from your Application Security console. Use the plugin to understand how traffic is moving between your server, apps, and authentication layer.

To get the most out of the Rapid7 AppSec plugin, we will walk through the following use cases:

  • Validate vulnerabilities by replaying the vulnerability attack. Replaying attacks allows you to watch the attack traffic to determine whether a vulnerability is valid.
  • Record macro authentication with the plugin and play the authentication sequences back to track user actions during authentication.
  • Record traffic authentication to track and send the requests the front end application and the back end server in a Traffic file. You can then import the file so it can be used and referenced within an app.

Install the plugin

  1. Ensure you are using the latest version of Chrome.
  2. On the Rapid7 AppSec Plugin for Chrome page, click Add to Chrome.
  3. In the extension pop-up, click Add extension.
  4. A notification appears when the plugin is successfully installed.

Validate vulnerabilities

In Application Security , you can access vulnerabilities and replay attacks from the scan report or vulnerability. Replaying attacks allows you to watch the attack traffic to determine whether a vulnerability is valid. You can also edit the request in the Request Builder to see if a change fixes or further validates a vulnerability.

Validate vulnerabilities workflow

After installing the plugin, you can generate a scan report or view vulnerabilities within a scan and replay the attack.

Validate by scan report

  1. On the Apps page, select the app you want to validate.
  2. On the app details page, select the scan you want to generate a report for.
  3. Click Generate Report
  4. Give the report a name and choose HTML export.
  5. When the report is available, replay the attack. a. Select an attack type and then click Replay Attack. b. In the Vulnerability Validator window, use the tabs at the top to switch between the steps in the attack traffic that occurred. c. On each tab, click Send to validate each attack with the Request Builder. The response headers and response body will return with the attack information.

Validate by vulnerability

  1. On the Apps page, select the app you want to validate.
  2. On the Vulnerabilities tab, select the vulnerability you want to validate.
  3. When the Vulnerability Validator window opens, replay the attack.
  4. Select an attack type and then click Replay Attack.
  5. In the Vulnerability Validator window, use the tabs at the top to switch between the steps in the attack traffic that occurred.
  6. On each tab, click Send to validate each attack with the Request Builder. The response headers and response body will return with the attack information.

Record and test macro authentication

Rapid7 AppSec Macros are sequences of actions, such as clicking a series of buttons or text entry on a web page. Once you have the AppSec Chrome plugin installed, you can use macros to record the actions needed to authenticate into an application or to access a specific section of your app that cannot be reached purely by crawling. You can record authentication with the Rapid7 AppSec Plugin in Application Security and in the Macro Recorder tab of the AppSec plugin. The playback option runs the same action sequence taken by the user.

Macro authentication workflow

After installing the plugin, you can record and play back the authentication sequence and edit the request before rewatching the authentication playback.

Record and play back login authentication

  1. In the Rapid7 AppSec plugin, on the Macro Recorder tab, enter the URL or local IP address of the site you want to record.
  2. Click Record authentication. A message at the top of the site recorder window confirms that the plugin is recording.
  3. On the login page of the site you are recording, enter your credentials and sign in.
  4. After logging in, click the Cancel button on the top page to close the window.
  5. In the plugin, choose the Macro Recorder tab to see the XML output of the sequence that was recorded.
  6. Before playing back the sequence, close all windows that were opened by the plugin.
  7. Click Playback.
Playback in Application Security

To playback the sequence in Application Security , download the .rec file and import into the macro Authentication tab.

Record and import traffic files

You may run into web applications built with technologies that are not supported by the Application Security crawler. You can authenticate into such applications by using a web proxy tool such as the Traffic Recorder in the Rapid7 Application Security plugin. Using the proxy tool, you can record the interactions (like HTTP GET and POST requests) between the front end application and the back end server in a Traffic File. Application Security can replay these interactions to authenticate into your application.

Traffic authentication workflow

After installing the plugin, you can record traffic from the plugin or a different tool, export the recorded file, and import it into Application Security.

Record using the Rapid7 AppSec plugin

  1. In the Rapid7 AppSec plugin, on the Traffic Recorder tab, enter the URL or local IP address of the site you want to record.
  2. Click Record authentication. A message at the top of the site recorder window confirms that the plugin is recording.
  3. On the login page of the site you are recording, enter your credentials and sign in.
  4. After logging in, click the Cancel button on the top page to close the window.
  5. In the Rapid7 AppSec plugin, click Download(*.har).
Import to Application Security

You can use this file in other applications or import it into Application Security.