Skip to content
DOM XSS scanner for Single Page Applications
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore first commit Oct 16, 2019
LICENSE Initial commit Oct 16, 2019
README.md
consts.js updated htcrawl Nov 8, 2019
domdig.js updated htcrawl Nov 8, 2019
package.json
payloads.js
utils.js

README.md

DOMDig

DOMDig is a DOM XSS scanner that runs inside the Chromium web browser and it can scan single page applications (SPA) recursively.
Unlike other scanners, DOMDig can crawl any webapplication (including gmail) by keeping track of DOM modifications and XHR/fetch/websocket requests and it can simulate a real user interaction by firing events. During this process, XSS payloads are put into input fields and their execution is tracked in order to find injection points and the related URL modifications.
It is based on htcrawl, a node library powerful enough to easily crawl a gmail account.

KEY FEATURES

  • Runs inside a real browser (Chromium)
  • Recursive DOM crawling engine
  • Handles XHR, fetch, JSONP and websockets requests
  • Supports cookies, proxy, custom headers, http auth and more
  • Scriptable login sequences

GETTING STARTED

Installation

git clone https://github.com/fcavallarin/domdig.git
cd domdig && npm i && cd ..
node domdig/domdig.js

Example

node domdig.js -c 'foo=bar' -p http:127.0.0.1:8080 https://htcap.org/scanme/domxss.php

Crawl Engine

DOMDig uses htcrawl as crawling engine, the same engine used by htcap.
The diagram shows the recursive crawling proccess.
SPA Crawling Diagram.
The video below shows the engine crawling gmail. The crawl lasted for many hours and about 3000 XHR request have been captured.

crawling gmail

Login Sequence

A login sequence (or initial sequence) is a json object containing a list of actions to take before the scan starts. Each element of the list is an array where the first element is the name of the action to take and the remaining elements are "parameters" to those actions. Actions are:

  • write <selector> <text>
  • click <selector>
  • clickToNavigate <selector>
  • sleep <seconds>

Example

[
   ["write", "#username", "demo"],
   ["write", "#password", "demo"],
   ["clickToNavigate", "#btn-login"]
]

Payloads file

Payloads can be loaded from json file (-P option) as array of strings. To build custom payloads, the string window.___xssSink({0}) must be used as the function to be executed (instead of the classic alert(1))

Example

[
   ';window.___xssSink({0});',
   '<img src="a" onerror="window.___xssSink({0})">'
]
You can’t perform that action at this time.