README.md

Proxy

This is a last resort method for testing our library on browsers that do not support JS injection via bookmarklet or devtools.

This script will setup a website proxy which will inject JS into webpages using a man-in-the-middle attack. It uses node-http-mitm-proxy.

To setup, we must start the proxy server, upload its certificate your iOS device, then connect it to the proxy.

Start the proxy server:
```
$ npm install
$ node proxy.js
```
You now want to send the proxy's certificate to your iOS device that you want to test. The certificate is generated after running the proxy and is located here:
```
.http-mitm-proxy/certs/ca.pem
```
You can email the file to your phone, and open the file attachment in Safari, which will proceed with the steps for adding the certificate as a trusted profile on your phone.
Now, make sure your phone is connected to the same Wifi network as the running proxy server. Under Settings > Wi-Fi > (Your Network), under HTTP Proxy, select Manual and fill in:
```
Server:    <your server's ip address>
Port:      8081
```
Finally, create a domains file in this directory, a whitelist of domains whose pages will be injected with JS. One domain per line.
```
example.com
github.com
```
Any webpage you navigate to on your phone should now have the injected JS.
NOTE: The proxy is a bit a flaky. Refreshing a page seems to crash the proxy server sometimes, so you will need to restart it when it does. The crash generally happens after most of the page and the script has loaded. Closing and reopening the browser sometimes helps.