-
Notifications
You must be signed in to change notification settings - Fork 126
Home
In the bottom right corner, there is an indicator that displays the state of the proxy:
Indicator | Meaning |
---|---|
Everything is OK, including HTTPS 👌 | |
HTTPS is not working, see next section 👇 |
Two different SSL-related files are required:
-
root-ca.key.pem
: a 'CA' key -
root-ca.crt.pem
: a 'CA' certificate
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:
OS | Config directory |
---|---|
Linux | $HOME/.config/james/ |
Mac | $HOME/Library/Application Support/James/ |
Windows | %AppData%\james\ |
The above table applies to James versions 1.5.0 and after. Prior to version 1.5.0, these files should be placed in the same directory you extracted James to.
Note that you'll know when you've found the James
folder to paste in, because the directory should have automatically been generated the first time you run James.
Nope, if you're not dealing with HTTPS requests, James will happily proxy HTTP requests without issues.
This happens when you haven't setup the SSL files necessary to proxy HTTPS requests. See the above section.
This is because your browser doesn't trust the certificate James is using to proxy requests with. You need to import the root-ca.crt.pem
file into your system/browser certificate store(s).