Deploying AcuSensor agent for Java - Docker Spring Boot in Acunetix 360

You can use AcuSensor to carry out interactive security testing (IAST) in your web application to confirm more vulnerabilities and further minimize false positives.  

For AcuSensor to operate, you need to download an agent and deploy it on your server. Please note that this agent is generated uniquely for each target website for security reasons.

This topic explains how to deploy AcuSensor together with your Spring Boot web application into a Docker container.

if_Gnome-Dialog-Information-64_55568.png

Information

The Java AcuSensor requires the following:

  • Deploying aspectjweaver.jar into your web server - provides the integration required for the AcuSensor to work with your application
  • Deploying the AcuSensor Java  into your web server - this is unique for each target
  • Configuring your web server to use Load Time Weaving (AspectJWeaver)

if_Gnome-Dialog-Information-64_55568.png

Information

This document assumes the following:

  • You will be using version 1.9.5 (latest at time of writing) of AspectJWeaver.
  • You are logged into the docker host as root, and all files for this web application will be kept in the folder "/root/myspringapp/"

Deploying AcuSensor in Java - Docker Spring Boot consists of 5 steps:

Before, going into details, you need to run the following command on the docker host to prepare the folder for the deployment: mkdir /root/myspringapp/

  1. Deploying AspectJWeaver for your container

  • Open a terminal
  • Run the following commands to download and deploy AspectJWeaver:
  1. Deploying AcuSensor for your container

  • Create a target website in Acunetix 360 for the exact URL of your new web application (for example http://myspringapp.example.com:8080/ )
  • Download the AcuSensor for Java for your web application target
  • Copy the AcuSensor (AcuSensor.jar) to the docker host into folder /root/myspringapp/
  1. Preparing Spring Boot

  • Build your application called, for this example, myspringapp.jar
  • Copy the JAR file for your web application myspringapp.jar to the docker host folder /root/myspringapp/
  1. Create Dockerfile

  • Run the following command to create and edit your Dockerfile: nano /root/myspringapp/Dockerfile
  • Edit the contents of your Dockerfile to show the following:

FROM openjdk:8-jdk-alpine

COPY Acusensor.jar Acusensor.jar

COPY aspectjweaver.jar aspectjweaver.jar

COPY myspringapp.jar myspringapp.jar

EXPOSE 8080

CMD java -javaagent:aspectjweaver.jar -Dacusensor.debug.log=ON -Dloader.path=Shark.jar -cp myspringapp.jar  org.springframework.boot.loader.PropertiesLauncher

Information

The parameter "-Dacusensor.debug.log=ON" is optional, and should ONLY be used for

troubleshooting purposes. If this parameter is retained, this will output AcuSensor logging as additional lines in the Tomcat logs starting with "[Acunetix-debug]".

  • 4.3. Save the Dockerfile and exit the nano editor
  1. Build your Docker Image and Start a Container

  • Run the following commands on the docker host:
  • cd /root/myspringapp/
  • docker build -t myspringapp:test .
  • docker run --publish 8080:8080 --detach --name myspringapp myspringapp:test

Now, you are ready to scan your new Spring Boot web application with Acunetix 360.


 
« Back to the Acunetix Support Page