backup/pywb
1
0
Fork 0
mirror of https://github.com/webrecorder/pywb.git synced 2025-03-15 00:03:28 +01:00
Code Issues Projects Releases Activity

Update configuring.rst

Browse Source
This commit is contained in:
notevenaperson 2023-04-24 12:51:10 +00:00 committed by GitHub
parent 83b2113be2
commit 8e7c548d50
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
docs/manual/configuring.rst
View File

@ -549,17 +549,18 @@ using the special download paths. Recommended set up for using the proxy is as f
2. Configure the browser proxy settings host port, for example ``localhost`` and ``8080`` (if running locally)
3. Download the CA:
3. Locate the CA:
* For most browsers, use the PEM format: ``http://wsgiprox/download/pem``
* The auto-generated pywb CA, created at ``./proxy-certs/pywb-ca.pem``.
* Alternatively, download and save the wsgiprox certificate, which is compatiable. For most browsers, use the PEM format: ``http://wsgiprox/download/pem``, For windows, use the PKCS12 format: ``http://wsgiprox/download/p12``
* For windows, use the PKCS12 format: ``http://wsgiprox/download/p12``
4. If you're not installing the CA system-wide, import the CA file in your browser's settings. On Chromium the menu is in ``chrome://settings/certificates``. On Firefox, ``Security > Certificates`` You may need to agree to "Trust this CA".
4. You may need to agree to "Trust this CA" to identify websites.
For more information on custom certificate authority (CA) installation, the `mitmproxy certificate page <https://docs.mitmproxy.org/stable/concepts-certificates/#installing-the-mitmproxy-ca-certificate-manually>`_ provides a good overview for installing a custom CA on different platforms.
The auto-generated pywb CA, created at ``./proxy-certs/pywb-ca.pem`` may also be added to a keystore directly.
The location of the CA file and the CA name displayed can be changed by setting the ``ca_file_cache`` and ``ca_name`` proxy options, respectively.
HTTPS Proxy and pywb Certificate Authority Configuration
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
The following are all the available proxy options -- only ``coll`` is required::
@ -571,6 +572,8 @@ The following are all the available proxy options -- only ``coll`` is required::
enable_banner: true
enable_content_rewrite: true
default_timestamp: ''
The location of the CA file and the CA name displayed can be changed by setting the ``ca_file_cache`` and ``ca_name`` proxy options, respectively.
The HTTP/S functionality is provided by the separate :mod:`wsgiprox` utility which provides HTTP/S proxy routing
to any WSGI application.
@ -581,8 +584,6 @@ Extensions to pywb can override ``proxy_route_request()`` to provide custom hand
See the `wsgiprox README <https://github.com/webrecorder/wsgiprox/blob/master/README.rst>`_ for additional details on setting a proxy resolver.
For more information on custom certificate authority (CA) installation, the `mitmproxy certificate page <http://docs.mitmproxy.org/en/stable/certinstall.html>`_ provides a good overview for installing a custom CA on different platforms.
Compatibility: Redirects, Memento, Flash video overrides
--------------------------------------------------------