aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorWojtek Kosior <koszko@koszko.org>2022-08-17 13:50:34 +0200
committerWojtek Kosior <koszko@koszko.org>2022-09-28 12:54:13 +0200
commitd54a95e0f9c689f2bbaaea90a3a16a855a408823 (patch)
tree2fcd758c6eaa7bc65a9744969a506c4ed24e0365 /README.md
parent2c98d04e4d4a344dc04a481b039a235678f7848e (diff)
downloadhaketilo-hydrilla-d54a95e0f9c689f2bbaaea90a3a16a855a408823.tar.gz
haketilo-hydrilla-d54a95e0f9c689f2bbaaea90a3a16a855a408823.zip
allow loading packages from zip files through web UI and listing installed mappings
Diffstat (limited to 'README.md')
-rw-r--r--README.md30
1 files changed, 20 insertions, 10 deletions
diff --git a/README.md b/README.md
index a3ee090..de97673 100644
--- a/README.md
+++ b/README.md
@@ -17,21 +17,24 @@ You're going to need at least Python 3.7 plus the following Python libraries
* mitmproxy 8 (sadly, not in Debian yet)
* immutables (also not in Debian but if you are familiar with git-buildpackage,
you can utilize [my own packaging of it](https://git.koszko.org/immutables/))
-* click
+* flask
* jsonschema (>= 3.0)
* beautifulsoup4
* html5lib
* babel
+* setuptools
+* setuptools_scm
+* wheel
-This project also utilizes flask, reuse, setuptools, setuptools_scm, wheel,
-pytest and mypy but those are either development-only dependencies or just not
-required for the actual Haketilo proxy.
+This project also utilizes reuse, pytest and mypy but those are either
+development-only dependencies or just not required for the actual Haketilo
+proxy.
Make sure to run
```
-./setup.py compile_catalog
+./setup.py build
```
-before running anything. A missing message catalog can make things break.
+before running anything. Otherwise, missing files can make things break.
Create directory ~/.haketilo/store/temporary_malcontent/ and put there all the
[built Haketilo packages](https://hydrillabugs.koszko.org/projects/hydrilla/wiki/Hydrilla_on-disk_data_format) that you'd like to use. You can use
@@ -44,10 +47,17 @@ PYTHONPATH=./src/ python3 -m mitmproxy_launcher
```
Next, open your browser, go to settings and import the certificate that got
-generated under ~/.haketilo/mitmproxy/mitmproxy-ca-cert.pem. You can now browse
-to some site for which you configured a Haketilo user script to run. I usually
-visit https://opencores.org/projects for which was the first Haketilo script was
-written...
+generated under ~/.haketilo/mitmproxy/mitmproxy-ca-cert.pem.
+
+Under (at least) Mozilla browsers, certificate pinning may cause mitmproxy's
+generated certificates to still be rejected. This generally happens on Google
+and Mozilla websites. To be able to access these through proxy, go to
+about:config and set the security.cert_pinning.enforcement_level preference to
+0.
+
+You can now browse to some site for which you configured a Haketilo user script
+to run. I usually visit https://opencores.org/projects for which the first
+Haketilo script was written...
There's some work to do before any of this will be usable to normal human
beings. Help appreciated.