busted
v1.0.0
Published
A node module that detects improper iframe busting code
Downloads
26
Maintainers
Readme
Busted
An npm package that detects improper iframe busting code and incorrect HTTP headers. "Clickjacking" is a malicious technique of tricking users into clicking on invisible iframes, and thus performing sensitive actions like sharing data or bank transfers without their knowledge. This tool attempts to find and offer suggestions to patch these vulnerabilities in your web applications. Also included are an Electron application, Chrome extension, and an Arachni check.
Install npm package
$ npm install busted
Usage
In a Node.js application (no DOM access to iframes, so only headers test is functional):
var busted = require('busted');
var URL = 'http://www.example.com';
busted.headersTest(URL, function(url, passed) {
console.log(url + (passed ? ' passed ' : ' failed ') + 'the headers test.');
});
In any Electron application (has DOM access so iframes can be tested):
window.BUSTED = require('busted.js');
var URL = 'http://www.example.com';
var iframe = document.getElementById('frame');
iframe.src = URL;
window.BUSTED.headersTest(URL, function(url, passed) {
console.log(url + (passed ? ' passed ' : ' failed ') + 'the headers test.');
});
iframe.onload = function() {
var passed = window.BUSTED.iframeTest(URL, iframe);
console.log(URL + (passed ? ' passed ' : ' failed ') + 'the iframe test.');
}
Using our Electron app
Our Electron app allows for scanning and testing URLs for the vulnerabilities.
Install
$ git clone https://github.com/nathanchapman/busted.git && cd busted/electron && npm install
Starting the app
From busted/electron
run:
$ npm start
Arachni Web Scanner Check
An Arachni check that tests headers and parses JavaScript for improper frame-busting code.
Install Arachni
Download and install Arachni.
Install Busted
$ git clone https://github.com/nathanchapman/busted.git
Move the arachni/clickjacking.rb
file to:
[ARACHNI_DIRECTORY]/system/gems/gems/arachni-1.4/components/checks/passive
from within [ARACHNI_DIRECTORY]
run the following:
$ bin/arachni --checks=clickjacking --scope-page-limit 1 --browser-cluster-pool-size 1 SOME_URL_OR_FILE
for more information, see the Arachni CLI guide.
Clickjacking Prevention
There are other attacks that are site-specific or are possible if the attacker controls certian domain names. These attacks cannot be tested here, but we will attempt to prevent them with this two-fold solution.
Headers: Set X-Frame-Options header to DENY or SAMEORIGIN
Frame Busting Code: Use the following frame busting code as a solution for older browsers that do not support X-Frame-Options or Content-Security-Policy headers.
<!-- Source: http://w2spconf.com/2010/papers/p27.pdf -->
<style>
html { display: none; }
</style>
<script>
if (self == top) {
document.documentElement.style.display = 'block';
} else {
top.location = self.location;
}
</script>