# self-unzip.html
[](https://pypi.org/project/self-unzip-html/)
This [repo](https://github.com/six-two/self-unzip.html) contains tools to create self-extracting HTML pages.
It works by taking a payload, compressing it, and encoding the results using ASCII85.
It then puts the resulting string in a template file, that contains the code to decode and decompress the payload again.
Currently there are three actions implemented, that can be executed, after the payload is decoded:
- `eval`: Execute payload as JavaScript code (example usecase: obfuscate malicious JS code)
- `replace`: Show payload as HTML page (example usecase: compress a big web page)
- `download`: Download the payload as a file (example usecase: bypass antivirus / filters)
## Demo
You can try the online demo at [self-extracting-html.six-two.dev](https://self-extracting-html.six-two.dev/).
This version is the same as the web version described below.
It is entirely client-site, your files do not get uploaded to a server.
## Installation
There are both a web and a python version. The web version is not actively developed anymore and very bare bones, but easy to use and requires no installation. The Python version has more features and is generally recommended.
### Current feature comparision
Currently the python version has the most features.
Feature | Web version | Python version
---|---|---
Base64 encoding | no | yes
Ascii85 encoding | yes | yes
GZIP compression | yes, always | yes, can be disabled
AES-GCM encryption | no | yes
Automatic detection of most efficient algorithms | no | yes
### Python version
A Python script to generate self extracting web pages is under `python/main.py`.
It just requires a modern Python version (probably Python3.9+) and has no mandatory external dependencies.
But if you want to use the encryption feature, you need to install `pycryptodomex` with pip.
You can install it with `pip` or docker.
#### pip
To install the latest release:
```bash
python3 -m pip install -U self-unzip-html
```
If you want to have the bleeding edge version (`main` branch), you can clone the repository and run:
```bash
python3 -m pip install .
```
Example usage of the pip package:
```bash
self-unzip-html --download -o psexec.html ~/Downloads/SysinternalsSuite/PsExec.exe
```
Or if you wanted to password-protect the output:
```bash
self-unzip-html --download -o psexec.html -p YourPasswordHere ~/Downloads/SysinternalsSuite/PsExec.exe
```
#### Docker
You can use the image pushed to ghcr.io:
```bash
docker run --rm -v "$PWD:/share" ghcr.io/six-two/self-unzip-html --download -o psexec.html ./PsExec.exe
```
To use the bleeding edge version (`main` branch), you can build the `Dockerfile`:
```bash
docker build -t self-unzip-html .
```
Usage of docker image:
```bash
docker run --rm -v "$PWD:/share" self-unzip-html --download -o psexec.html ./PsExec.exe
```
You can show all flags with the `--help` flag and can see some example commands in `./test.sh`.
#### Phishing
If you want to use it for phishing (sending a download link to a malicious file), the `--driveby-redirect` is likely what you want. It starts a download and immediately redirects to any URL you choose, so that it looks like the other site started the download:
Just search for a "thank you for downloading" page that does not start a download. There are many of them for software like Skype, AnyDesk, etc. Then rename your payload file to something an visitor of the download page would expect and create the HTML smuggling page:
```bash
self-unzip-html.py AnyDesk.exe -o anydesk-download.html --driveby-redirect https://anydesk.com/en/downloads/guide/thank-you --obscure-action
```
Host that HTML file on your server and link to it in your emails.
#### Encryption
Encryption uses AES-GCM for encryption and tamper detection and PBKDF2 with slightly over 1 million rounds of SHA-256 for password derivation.
The code has not been audited, so use it with caution.
If data security is very important to you may want to manually encrypt it beforehand (for example using `gpg`).
You can automatically decrypt a page by adding the password as the hash in a URL like `encrypted.html#monkey123!`.
The hash will not be sent to the server, so your password may only be stored locally (in your browsing history).
Otherwise a prompt will ask you for the password.
#### Custom actions
With the `--custom` flag you can specify your own JavaScript that should handle the unpacked data. The data is passed via the `og_data` parameter.
The value is an Uint8Array which represents the bytes of the input file. If you want to interpret it as UTF-8 text and convert it to a string, you can use `new TextDecoder().decode(og_data)`.
If you want to build your payload based on one of the builtin payloads, you can find them in `python/self_unzip_html/static_js.py`
When debugging your own payload it can be useful to see go through it step by step. For this I find it easiest to create an page with:
```bash
self-unzip-html README.md --custom 'window.og_data = og_data' -o test_custom.html
```
The resulting page exposes og_data in the global scope. You can then paste your payload into the JavaScript console piece by piece and inspect the output or DOM in between.
### Web version
There is a bare-bones page generator written in plain HTML and JavaScript.
To use it, just clone the repo and put the contents of the `site` directory somewhere in your web server directory.
You can of course also use it with Python's built in web server:
```bash
python3 -m http.server --directory ./site/
```
I also host it via Vercel at <https://self-extracting-html.six-two.dev/>.
## JavaScript code
### Python
The JavaScript code is modular to decrease size and allow mixing and matching different algorithms.
The unminified files are in `code_to_minify/`.
They are minified by running `code_to_minify/build.sh`, which updates `python/self_unzip_html/minified_js.py`.
### template.html
This basically just explains, how I generated the obfuscated script in `template.html` (JavaScript version).
In case you are paranoid, you can reproduce the steps.
Or if there is an important update to `fflate` or `ascii85`, I will have to run them again.
Install with npm:
```bash
npm install .
```
First use rollup to only select the actually used code:
```bash
./node_modules/.bin/rollup -c rollup.config.js
```
This command should create `output/main.js`
The next step is optional.
If you want to skip it, just rename `main.min.js` to `main.js` in the `output` directory.
Otherwise minify the code (may require you to install an external minifier like closure-compiler).
```bash
closure-compiler output/main.js --js_output_file output/main.min.js
```
## Notable changes
### Version 0.2.1
- Added `Dockerfile` and published image `docker pull ghcr.io/six-two/self-unzip-html`
- Added `--show-text` action, which shows the payload as plain text
### Version 0.2.0
- **Breaking change**: Replaced the `--type` parameter with specific flags like `--download`, `--driveby-redirect`, `--eval`, `--replace`, and `--custom`.
- `--download` now has an optional parameter that allows you to change the file's name.
- `--driveby-redirect` allows you to perform a driveby download and redirect the visitor immediately to another page.
- `--custom` allows you to provide your own JavaScript code, which is useful for not implemented techniques or special usecases.
- Password protection now encrypts the payload action too.
This should prevent anyone without the password from inspecting the file and for example seeing that it performs a drive by download and redirects to a specific site.
- The debugging console messages are disabled by default, which results in nicer and shorter code.
If enabled with the `--console-log` flag, the data will be formatted as hex dumps for easier debugging.
- Added `--html`, `--html-file` and `--title` options to change the visual appearence of the initial page without needing a whole custom template.
Raw data
{
"_id": null,
"home_page": "https://github.com/six-two/self-unzip.html",
"name": "self-unzip-html",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "six-two",
"author_email": "pip@six-two.dev",
"download_url": "https://files.pythonhosted.org/packages/ec/b8/fb8efd5325d6e341b6d88f3ec99e5ef97308487eb80f96d0ccf19fa4092e/self_unzip_html-0.2.1.tar.gz",
"platform": null,
"description": "# self-unzip.html\n[](https://pypi.org/project/self-unzip-html/)\n\n\n\nThis [repo](https://github.com/six-two/self-unzip.html) contains tools to create self-extracting HTML pages.\nIt works by taking a payload, compressing it, and encoding the results using ASCII85.\nIt then puts the resulting string in a template file, that contains the code to decode and decompress the payload again.\n\nCurrently there are three actions implemented, that can be executed, after the payload is decoded:\n\n- `eval`: Execute payload as JavaScript code (example usecase: obfuscate malicious JS code)\n- `replace`: Show payload as HTML page (example usecase: compress a big web page)\n- `download`: Download the payload as a file (example usecase: bypass antivirus / filters)\n\n## Demo\n\nYou can try the online demo at [self-extracting-html.six-two.dev](https://self-extracting-html.six-two.dev/).\nThis version is the same as the web version described below.\nIt is entirely client-site, your files do not get uploaded to a server.\n\n## Installation\n\nThere are both a web and a python version. The web version is not actively developed anymore and very bare bones, but easy to use and requires no installation. The Python version has more features and is generally recommended.\n\n### Current feature comparision\n\nCurrently the python version has the most features.\n\nFeature | Web version | Python version\n---|---|---\nBase64 encoding | no | yes\nAscii85 encoding | yes | yes\nGZIP compression | yes, always | yes, can be disabled\nAES-GCM encryption | no | yes\nAutomatic detection of most efficient algorithms | no | yes\n\n### Python version\n\nA Python script to generate self extracting web pages is under `python/main.py`.\nIt just requires a modern Python version (probably Python3.9+) and has no mandatory external dependencies.\nBut if you want to use the encryption feature, you need to install `pycryptodomex` with pip.\n\nYou can install it with `pip` or docker.\n\n#### pip\n\nTo install the latest release:\n```bash\npython3 -m pip install -U self-unzip-html\n```\n\nIf you want to have the bleeding edge version (`main` branch), you can clone the repository and run:\n```bash\npython3 -m pip install .\n```\n\nExample usage of the pip package:\n```bash\nself-unzip-html --download -o psexec.html ~/Downloads/SysinternalsSuite/PsExec.exe\n```\n\nOr if you wanted to password-protect the output:\n```bash\nself-unzip-html --download -o psexec.html -p YourPasswordHere ~/Downloads/SysinternalsSuite/PsExec.exe\n```\n\n#### Docker\n\nYou can use the image pushed to ghcr.io:\n```bash\ndocker run --rm -v \"$PWD:/share\" ghcr.io/six-two/self-unzip-html --download -o psexec.html ./PsExec.exe \n```\n\nTo use the bleeding edge version (`main` branch), you can build the `Dockerfile`:\n```bash\ndocker build -t self-unzip-html .\n```\n\nUsage of docker image:\n```bash\ndocker run --rm -v \"$PWD:/share\" self-unzip-html --download -o psexec.html ./PsExec.exe \n```\n\nYou can show all flags with the `--help` flag and can see some example commands in `./test.sh`.\n\n#### Phishing\n\nIf you want to use it for phishing (sending a download link to a malicious file), the `--driveby-redirect` is likely what you want. It starts a download and immediately redirects to any URL you choose, so that it looks like the other site started the download:\n\n\n\nJust search for a \"thank you for downloading\" page that does not start a download. There are many of them for software like Skype, AnyDesk, etc. Then rename your payload file to something an visitor of the download page would expect and create the HTML smuggling page:\n```bash\nself-unzip-html.py AnyDesk.exe -o anydesk-download.html --driveby-redirect https://anydesk.com/en/downloads/guide/thank-you --obscure-action\n```\n\nHost that HTML file on your server and link to it in your emails.\n\n#### Encryption\n\nEncryption uses AES-GCM for encryption and tamper detection and PBKDF2 with slightly over 1 million rounds of SHA-256 for password derivation.\nThe code has not been audited, so use it with caution.\nIf data security is very important to you may want to manually encrypt it beforehand (for example using `gpg`).\n\nYou can automatically decrypt a page by adding the password as the hash in a URL like `encrypted.html#monkey123!`.\nThe hash will not be sent to the server, so your password may only be stored locally (in your browsing history).\nOtherwise a prompt will ask you for the password.\n\n#### Custom actions\n\nWith the `--custom` flag you can specify your own JavaScript that should handle the unpacked data. The data is passed via the `og_data` parameter.\nThe value is an Uint8Array which represents the bytes of the input file. If you want to interpret it as UTF-8 text and convert it to a string, you can use `new TextDecoder().decode(og_data)`.\nIf you want to build your payload based on one of the builtin payloads, you can find them in `python/self_unzip_html/static_js.py`\n\nWhen debugging your own payload it can be useful to see go through it step by step. For this I find it easiest to create an page with:\n```bash\nself-unzip-html README.md --custom 'window.og_data = og_data' -o test_custom.html\n```\nThe resulting page exposes og_data in the global scope. You can then paste your payload into the JavaScript console piece by piece and inspect the output or DOM in between.\n\n### Web version\n\nThere is a bare-bones page generator written in plain HTML and JavaScript.\nTo use it, just clone the repo and put the contents of the `site` directory somewhere in your web server directory.\n\nYou can of course also use it with Python's built in web server:\n```bash\npython3 -m http.server --directory ./site/\n```\n\nI also host it via Vercel at <https://self-extracting-html.six-two.dev/>.\n\n## JavaScript code\n\n### Python\n\nThe JavaScript code is modular to decrease size and allow mixing and matching different algorithms.\nThe unminified files are in `code_to_minify/`.\nThey are minified by running `code_to_minify/build.sh`, which updates `python/self_unzip_html/minified_js.py`.\n\n### template.html\n\nThis basically just explains, how I generated the obfuscated script in `template.html` (JavaScript version).\nIn case you are paranoid, you can reproduce the steps.\nOr if there is an important update to `fflate` or `ascii85`, I will have to run them again.\n\nInstall with npm:\n\n```bash\nnpm install .\n```\n\nFirst use rollup to only select the actually used code:\n\n```bash\n./node_modules/.bin/rollup -c rollup.config.js\n```\n\nThis command should create `output/main.js`\n\nThe next step is optional.\nIf you want to skip it, just rename `main.min.js` to `main.js` in the `output` directory.\nOtherwise minify the code (may require you to install an external minifier like closure-compiler).\n\n```bash\nclosure-compiler output/main.js --js_output_file output/main.min.js\n```\n\n## Notable changes\n\n### Version 0.2.1\n\n- Added `Dockerfile` and published image `docker pull ghcr.io/six-two/self-unzip-html`\n- Added `--show-text` action, which shows the payload as plain text\n\n### Version 0.2.0\n\n- **Breaking change**: Replaced the `--type` parameter with specific flags like `--download`, `--driveby-redirect`, `--eval`, `--replace`, and `--custom`.\n - `--download` now has an optional parameter that allows you to change the file's name.\n - `--driveby-redirect` allows you to perform a driveby download and redirect the visitor immediately to another page.\n - `--custom` allows you to provide your own JavaScript code, which is useful for not implemented techniques or special usecases.\n- Password protection now encrypts the payload action too.\n This should prevent anyone without the password from inspecting the file and for example seeing that it performs a drive by download and redirects to a specific site.\n- The debugging console messages are disabled by default, which results in nicer and shorter code.\n If enabled with the `--console-log` flag, the data will be formatted as hex dumps for easier debugging.\n- Added `--html`, `--html-file` and `--title` options to change the visual appearence of the initial page without needing a whole custom template.\n",
"bugtrack_url": null,
"license": "MIT License",
"summary": "Create self-extracting and/or password protected HTML pages with arbitrary contents",
"version": "0.2.1",
"project_urls": {
"Homepage": "https://github.com/six-two/self-unzip.html"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "547f7a1bcecc9de0a3740d34d6067aa6d1376c8375889a7bb5f7708c5cff4d7f",
"md5": "a87fc2069e9d5e709e9f95c5e0c8696d",
"sha256": "157f47e6b37b5c07754dfd481b90d5dddb12f9fca79794ef78b7078e18a7acdb"
},
"downloads": -1,
"filename": "self_unzip_html-0.2.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a87fc2069e9d5e709e9f95c5e0c8696d",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 17164,
"upload_time": "2024-08-31T19:32:05",
"upload_time_iso_8601": "2024-08-31T19:32:05.866707Z",
"url": "https://files.pythonhosted.org/packages/54/7f/7a1bcecc9de0a3740d34d6067aa6d1376c8375889a7bb5f7708c5cff4d7f/self_unzip_html-0.2.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ecb8fb8efd5325d6e341b6d88f3ec99e5ef97308487eb80f96d0ccf19fa4092e",
"md5": "130ae1b7f47c5d27829903cd941d2927",
"sha256": "4bcdee59b37d38dbc1bead451508fdea7d821f50d60db5cf44ac2cc77503ab27"
},
"downloads": -1,
"filename": "self_unzip_html-0.2.1.tar.gz",
"has_sig": false,
"md5_digest": "130ae1b7f47c5d27829903cd941d2927",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 18909,
"upload_time": "2024-08-31T19:32:07",
"upload_time_iso_8601": "2024-08-31T19:32:07.505593Z",
"url": "https://files.pythonhosted.org/packages/ec/b8/fb8efd5325d6e341b6d88f3ec99e5ef97308487eb80f96d0ccf19fa4092e/self_unzip_html-0.2.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-08-31 19:32:07",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "six-two",
"github_project": "self-unzip.html",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "self-unzip-html"
}
JSON
