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

Merge 8e7c548d506cf169fcf7a42f80e38a9b42b0eb30 into 7b0f8b58607fb0ed338f0cfddeb80c629582d8f6

Browse Source
This commit is contained in:
notevenaperson 2024-11-14 10:03:30 +00:00 committed by GitHub
commit f6d66854af
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 10 additions and 9 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
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``.
* For windows, use the PKCS12 format: ``http://wsgiprox/download/p12``
* 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``
4. You may need to agree to "Trust this CA" to identify websites.
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".
The auto-generated pywb CA, created at ``./proxy-certs/pywb-ca.pem`` may also be added to a keystore directly.
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 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::
@ -572,6 +573,8 @@ The following are all the available proxy options -- only ``coll`` is required::
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
--------------------------------------------------------