wonderxss

README

wonderxss

Blind-XSS tool.

Work in progress

Features:

• 0 runtime dependencies
• Realtime (websocket)
• Authentication
  • 2FA (Google Authenticator, Authy...)
  • JWT
  • Oauth2
• Extensible
  • Event system
  • REST API
  • Internal API
  • Interfaces
    • CLI
    • Web UI
• Notification services
  • Slack
  • Discord
  • Email
  • Web UI (websocket)
• Payload Generator
• One click deploy
  • Terraform
  • Docker
  • Vagrant
  • Github release (binary)

Roadmap:

• DNS Listenner
• Authorization

How to

1. Start the application (edit the wonderxss.conf file if needed)
2. Create a new payload by visiting https://yourdomain.tld/editor and filling up the form.
   1. Add an optional alias. Let's say a so you get a short injection payload.
3. Go back to the home page and select the payload you want to create an injection for.
   1. Check or uncheck the use of the subdomain
   2. Copy paste the injection
4. Inject your payload in some vulnerable application
5. Wait to the application to trigger your payload.
   1. If you have set up a notification system, you will also get a notification on trigger

Deploy & Run

Deployment methods are WIP Currently, you will have to build the execute the project:

git clone https://github.com/Edznux/wonderxss
cd wonderxss
export WONDERXSS_DOMAIN=example.com
go build
# Only sets the cap_net_bind_service to bind.
# You can also directly use `sudo ./wonderxss`
sudo setcap 'cap_net_bind_service=+ep' ./wonderxss
./wonderxss

Frontend

The frontend UI is really WIP. You will need to run the following commands to get it running:

cd ui/wonderxss/
npm install

# this next command will serve the app on a different port.
# You may have CORS and/or port issue
npm start # If you get some permission error, run as sudo ;)

# Later, we will bundle the frontend with the rest of the app. We will use:
npm run build

API

Prefix: /api/v1/

Routes:

/healthz              [GET]
/users/{id}           [GET]

/payloads             [POST,GET]
/payloads/{id}        [GET,PUT,DELETE]

/aliases              [POST, GET]
/aliases/{id}         [DELETE]
/aliases/{alias}      [GET]
/aliases/id/{id}      [GET]
/aliases/payload/{id} [GET]

/executions           [GET]
/executions/{id}      [DELETE]

/loots           [GET,POST]
/loots/{id}      [DELETE]

/injections           [GET,POST]
/injections/{name}    [GET]
/injections/{id}      [DELETE]

Configuration

Example configuration file (cp wonderxss.conf.example wonderxss.conf)

# Domain to listen on. (Usefull only for sudomains paylaod aliases)
domain = "localhost"
# Type of database
database = "sqlite"
# true will enable listening on HTTPS (without a reverse proxy). Disabled by default.
# This will require certificates:
# self signed RSA: `openssl req -x509 -nodes -newkey rsa:2048 -keyout server.key -out server.crt -days 3650`
# Use letsencrypt or other trusted provider for production environment
standalone_https = true

# Lists of notification systems
[notifications]
  # slack-webhook is an arbitrary name. Use whatever you prefer.
  # TODO:
  # You can use multiple times the same kind of notification
  # For example, multiple slack channels
  [notifications.slack-webhook]
    name    = "slack"
    # Change this token
    token   = "test"
    # Globaly disable this kind of notifications
    enabled = true

# Databases definitions
[storages]
  [storages.sqlite]
    adapter = "sqlite"
    # name of the sqlite file
    file    = "db.sqlite"

Environment variables:

WONDERXSS_DOMAIN: Domain to listen on. Usefull for wildcard subdomain. WONDERXSS_HTTPS: true will enable listening on HTTPS (without a reverse proxy). Disabled by default. This will require certificates: (self signed RSA: openssl req -x509 -nodes -newkey rsa:2048 -keyout server.key -out server.crt -days 3650) (Use letsencrypt or other trusted provider for prod) WONDERXSS_STORE: Select the database used by wonderxss. Default: sqlite

Documentation

Overview

Code generated for package main by go-bindata DO NOT EDIT. (@generated) sources: ui/wonderxss/build/asset-manifest.json ui/wonderxss/build/favicon.ico ui/wonderxss/build/index.html ui/wonderxss/build/logo192.png ui/wonderxss/build/logo512.png ui/wonderxss/build/manifest.json ui/wonderxss/build/precache-manifest.dda8e615b1fe8078462b8d43336ff537.js ui/wonderxss/build/robots.txt ui/wonderxss/build/service-worker.js