Skip to content

Installation and Debugging

plokta edited this page Jun 28, 2019 · 1 revision

Installation can be done either through the Burp Suite Extender (BApp Store) or via this GitHub page, using the source code or a JAR file. We recommend using the Extender inside of Burp for installation. In the event that Port Swigger does not have the latest version available in the BApp Store, you can download the latest version of EsPReSSO (either in source code or as a JAR file) from our releases page.

Building From Source Code

  • Build the JAR file in the terminal using the following command or download it from releases:
   $ mvn clean package
  • Load the JAR file from the target folder into Burp's Extender.
  • See our page on Using EsPReSSO for more information on its features.

Debugging

For developers, debugging can be done by launching Burp Suite using the following command:

java -jar -Xdebug -Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=9999 burpsuite_community_v1.7.32.jar

You can then attach your debugger on localhost:9999

Merging with Remote Git Repo

git remote add upstream https://[user]@github.com/RUB-NDS/BurpSSOExtension.git
git push -u upstream development-branch:master
git remote remove upstream

Dependencies and Licences

Dependency Licence Access Date Link Copyright (c) Date, Name
RSyntaxTextArea modified BSD license 20.09.2015 https://github.com/bobbylight/RSyntaxTextArea 2012, Robert Futrell
json-simple Apache License 2.0 20.09.2015 https://code.google.com/p/json-simple/ Unkown, Yidong Fang
WSAttacker GNU General Public License v2.0 20.09.2015 https://github.com/RUB-NDS/WS-Attacker/ 2012, Christian Mainka, Andreas Falkenberg, Juraj Somorovsky, et al.
junit Eclipse Public License 1.0 12.03.2018 https://github.com/junit-team/junit4 Unkown, Erich Gamma and Kent Beck.
jutf7 MIT license 12.03.2018 https://sourceforge.net/projects/jutf7/ 2011, Jaap Beetstra
commons-io Apache License 2.0 12.03.2018 https://github.com/apache/commons-io 2012, Scott Sanders, et al.

Tested with:

  • Java 1.8.0._151
  • Burp Suite 1.7.32
  • Ubuntu 16.04.3 LTS, amd64
  • Netbeans 8.2
  • Maven 3.3.9