Skip to content

Commit 97828a7

Browse files
authored
update doc (#21)
1 parent 03a5c49 commit 97828a7

File tree

1 file changed

+10
-3
lines changed

1 file changed

+10
-3
lines changed

docs/source/forward-proxy.rst

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -42,6 +42,8 @@ Then, you can follow the steps below to install the plugin:
4242

4343
- Ensure that you are running the scion-endhost stack as described in the `SCION documentation <https://docs.scion.org/projects/scion-applications/en/latest/applications/access.html>`_.
4444

45+
- Apply the necessary permissions to the binary:
46+
4547
.. code-block:: bash
4648
4749
chmod +x scion-caddy
@@ -61,7 +63,6 @@ Then, you can follow the steps below to install the plugin:
6163
sudo mkdir -p /usr/share/scion/caddy-scion
6264
sudo chown -R $USER:$USER /usr/share/scion
6365
64-
- Apply the necessary permissions to the binary:
6566
6667
- Optionally you can create a systemd service and enable it. You can use the example service file ``scion-caddy.service`` in the `examples <https://github.com/scionproto-contrib/caddy-scion/tree/main/_examples>`__.
6768

@@ -180,8 +181,14 @@ Add the following line on ``/etc/hosts`` before running the SCION HTTP Forward P
180181
The primary option for connecting to the SCION HTTP Forward Proxy is over HTTPS.
181182
Most browsers or HTTPS clients will not trust the self-signed certificate used by the SCION HTTP Forward Proxy by default. To avoid certificate warnings, the user must either:
182183

183-
- Import the root certificate use into the browser trust store. If the user has followed the installation examples in the `examples <https://github.com/scionproto-contrib/caddy-scion/tree/main/_examples>`__ folder, the root certificate can be found in the ``/usr/share/scion/caddy-scion`` directory.
184-
For MacOS, the root certificate can be found in the ``/usr/local/scion/caddy-scion`` directory. Please, use the Keychain Access application to import the root certificate.
184+
- Import the root certificate used into the browser trust store.
185+
If the user has followed the installation examples in the `examples <https://github.com/scionproto-contrib/caddy-scion/tree/main/_examples>`__ folder, the root certificate can be found in the ``/usr/share/scion/caddy-scion/pki/authorities/local/root.crt`` directory.
186+
187+
For Linux and Windows, you can import the root certificate into the system trust store. The chromium-based browsers require the root certificate to be imported into the browser trust store as well.
188+
189+
- Go to `chrome://certificate-manager/` -> "Installed by you" -> "Import" -> select the `root.crt` retrieved previously.
190+
191+
For MacOS, use the Keychain Access application to import the root certificate.
185192
- Disable certificate verification in the browser or client, e.g.:
186193
- Run chrome with, ``chrome --ignore-certificate-errors``
187194
- Use the ``--proxy-insecure`` flag with curl, e.g.:

0 commit comments

Comments
 (0)