Website Modification Proxy
wmod-proxy
is a simple javascript MITM HTTP/HTTPS proxy built with Mockttp toolkit.
It's used to inject scripts into existing websites. Website Modification Script: Twitter is an example of such a script. See its README for more details.
MITM stands for man-in-the-middle cyberattack. It's also a great opportunity to modify almost any existing website or web application in a big scale.
But what about browser extensions, you say, ain't they created for that purpose?
Well, they are. But after years of browser development, they have been finally rendered pretty limited in their capabilities. They're executed in a separate process, and they can't effectively interfere with a web app, they can't even read what the app receives via the network. But we could perfectly achieve that by injecting a script into the page itself.
It's an experimental project and is still under active development.
Install
$ npm i wmod-proxy
Usage
To run the proxy on port 8000 and to start injecting scripts from path/to/wmod
:
$ npx wmod-proxy 8000 path/to/wmod
It will look for manifest.js
file, which describes the modification details.
Manifest.js
Here is an example of Manifest-file, which can be found here:
module.exports = {
// Wmod name
name: 'test',
// Wmod version
version: '0.0.1',
// Wmod description
description: 'Test1',
// A list of available modification script groups i.e. "scripts"
scripts: [
{
// A name of the script
name: 'default',
// A list of files of the script
files: [
{
// A path to the file
path: 'inject.js',
// A boolean flag indicating, if this file should be injected.
// F.e. source map files don't need an injection.
inject: true,
},
],
},
],
rules: [
// A list of rules of response modifications: files injections,
// connection abortions etc
{
// URL hostname to match
hostname: 'twitter.com',
// URL path to match
path: /^\/(home|search)/,
// What has to be done with the matched reponses
action: {
// A list of script names to apply for the rule
scripts: ['default'],
},
},
{
hostname: 'ton.local.twitter.com',
action: {
// HTTP status code to send as a response
response: 404,
},
},
],
};
Plans
Currently, we can essentially inject only one script at a time. Thus, one obvious direction of development is to make it a script manager with its own script storage.