HTMLSmuggler - HTML Smuggling Generator And Obfuscator For Your Red Team Operations

The full explanation what is HTML Smuggling may be found here.

The primary objective of HTML smuggling is to bypass network security controls, such as firewalls and intrusion detection systems, by disguising malicious payloads within seemingly harmless HTML and JavaScript code. By exploiting the dynamic nature of web applications, attackers can deliver malicious content to a user's browser without triggering security alerts or being detected by traditional security mechanisms. Thanks to this technique, the download of a malicious file is not displayed in any way in modern IDS solutions.

The main goal of HTMLSmuggler tool is creating an independent javascript library with embedded malicious user-defined payload. This library may be integrated into your phishing sites/email html attachments/etc. to bypass IDS and IPS system and deliver embedded payload to the target user system. An example of created javascript library may be found here.

Features

Built-in highly configurable JavaScript obfuscator that fully hides your payload.
May be used both as an independent JS library or embedded in JS frameworks such as React, Vue.js, etc.
The simplicity of the template allows you to add extra data handlers/compressions/obfuscations.

Installation

Install yarn package manager.
Install dependencies:
Read help message.
Usage
Preparation steps
1. Modify (or use my) javascript-obfuscator options in obfuscator.js, my preset is nice, but very slow.
2. Compile your javascript payload:
```
yarn build -p /path/to/payload -n file.exe -t "application/octet-stream" -c
```
3. Get your payload from dist/payload.esm.js or dist/payload.umd.js. After that, it may be inserted into your page and called with download() function.
payload.esm.js is used in import { download } from 'payload.esm'; imports (ECMAScript standart).

payload.umd.js is used in html script SRC and require('payload.umd'); imports (CommonJS, AMD and pure html).

Pure HTML example

A full example may be found here.
1. Do preparation steps.
2. Import created script to html file (or insert it inline):
```
<head>
  <script src="payload.umd.js"></script>
</head>
```
3. Call download() function from body:
```
<body>
  <button onclick="download()">Some phishy button</button>
</body>
```
4. Happy phishing :)
VueJS example

A full example may be found here.
1. Do preparation steps.
2. Import created script to vue file:
```
<script>
  import { download } from './payload.esm';
</script>
```
3. Call download() function:
```
<template>
  <button @click="download()">Some phishy button</button>
</template>
```
4. Happy phishing :)
FAQ

Q: I have an error RangeError: Maximum call stack size exceeded, how to solve it?

A: This issue described here. To fix it, try to disable splitStrings in obfuscator.js or make smaller payload (it's recommended to use up to 2 MB payloads because of this issue).

Q: Why does my payload build so long?

A: The bigger payload you use, the longer it takes to create a JS file. To decrease time of build, try to disable splitStrings in obfuscator.js. Below is a table with estimated build times using default obfuscator.js.

Payload size Build time

525 KB 53 s

1.25 MB 8 m

3.59 MB 25 m

Payload size	Build time
525 KB	53 s
1.25 MB	8 m
3.59 MB	25 m

Features

Installation

Preparation steps

Pure HTML example

VueJS example

FAQ