Home

SSL Proxying

Is James already proxying HTTPS requests?

The footer shows an indicator that shows you the state of the proxy:

Indicator	Meaning
	Everything is OK, including HTTPS 👌
	HTTPS is not working, see next section 👇

James isn't "doing the HTTPS", what do I do?

Two different SSL-related files are required:

• a "CA" key: root-ca.key.pem
• and a "CA" certificate: root-ca.crt.pem

For information about these files, see Hoxy's details here and here.

Assuming openssl on your machine, run the following:

openssl genrsa -out root-ca.key.pem 2048
openssl req -x509 -new -nodes -key root-ca.key.pem -days 1024 -out root-ca.crt.pem -subj "/O=James Proxy Signing Authority"

This will generate the two required files, root-ca.key.pem and root-ca.crt.pem.

Import root-ca.crt.pem into each device/browser that you will be using James with, in order to allow the browsers to trust James and not throw a warning when James proxies HTTPS requests.

Additionally, place both files in James' config directory. This directory is different for each OS:

• Linux: $HOME/.config/james/
• Mac: $HOME/Library/Application Support/James/
• Windows: %AppData%\james