Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
omercnet authored May 30, 2020
1 parent d95d739 commit 7b0c884
Showing 1 changed file with 5 additions and 6 deletions.
11 changes: 5 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# BurpJDSer-ng


A Burp Extender plugin, that will deserialized java objects and encode them in XML using the [Xtream](https://x-stream.github.io/) library.
A Burp Extender plugin, that will deserialized java objects and encode them in JSON using the [Xtream](https://x-stream.github.io/) library.

Based in part on [khai-tran](https://github.com/khai-tran/BurpJDSer)'s work but written from scratch to work with the new Extender API introduced in Burp-1.5.01

Expand All @@ -16,13 +16,12 @@ Few methods to locate the required jar files containing the classes we'll be des
Finally, create a "libs/" directory next to your burp.jar and put all the jars in it.

### 2) Start Burp plugin
Download from [here](https://github.com/omercnet/BurpJDSer-ng/raw/master/dist/BurpJDSer-ng.jar) and simply load it in the Extender tab, the Output window will list all the loaded jars from ./libs/

Download from [releases page](https://github.com/omercnet/BurpJDSer-ng/releases) and load it in the Extender tab, the Output window will list all the loaded jars from ./libs/

### 3) Inspect serialized Java traffic
Serialized Java content will automagically appear in the Deserialized Java input tab in appropriate locations (proxy history, interceptor, repeater, etc.)
Any changes made to the XML will serialize back once you switch to a different tab or send the request.
Serialized Java content will automagically appear in the `Java Object` tab in appropriate locations (proxy history, interceptor, repeater, etc.)
Any changes made to the JSON will serialize back once you switch to a different tab or send the request.

**Please note that if you mess up the XML schema or edit an object in a funny way, the re-serialization will fail and the error will be displayed in the input tab**
**Please note that if you mess up the JSON schema or edit an object in a funny way, the re-serialization will fail and the error will be displayed in the Dashboard tab**

In case you need to add more JARs, right click anywhere and select "BurpJDSer-ng: Reload JARs"

0 comments on commit 7b0c884

Please sign in to comment.