Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/rarecoil/unwebpack-sourcemap
Extract uncompiled, uncompressed SPA code from Webpack source maps.
https://github.com/rarecoil/unwebpack-sourcemap
information-disclosure security-tool security-tools sourcemaps spa webpack4
Last synced: 21 days ago
JSON representation
Extract uncompiled, uncompressed SPA code from Webpack source maps.
- Host: GitHub
- URL: https://github.com/rarecoil/unwebpack-sourcemap
- Owner: rarecoil
- License: mit
- Archived: true
- Created: 2019-06-12T22:42:21.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-04-16T06:46:45.000Z (over 2 years ago)
- Last Synced: 2024-11-04T23:37:24.277Z (about 1 month ago)
- Topics: information-disclosure, security-tool, security-tools, sourcemaps, spa, webpack4
- Language: Python
- Homepage: https://medium.com/@rarecoil/spa-source-code-recovery-by-un-webpacking-source-maps-ef830fc2351d
- Size: 329 KB
- Stars: 497
- Watchers: 10
- Forks: 196
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-hacking-lists - rarecoil/unwebpack-sourcemap - Extract uncompiled, uncompressed SPA code from Webpack source maps. (Python)
README
# unwebpack-sourcemap
# Archive Notice (April 15 2022)
This script seems to be helpful for many, but unfortunately I also do not have time to maintain it and properly code review the work of potential contributors. I'll leave it in an archived state for a while for anyone that wants to fork it, but I will eventually delete this repository.
### Recover uncompiled TypeScript sources, JSX, and more from Webpack sourcemaps.
As single-page applications take over the world, more and more is being asked of the browser as a client. It is common for SPAs to use [Webpack](https://webpack.js.org/) to handle browser script build processes. Usually, Webpack will transpile React/Vue/TypeScript/etc. to JavaScript, minify/compress it, and then serve it as a single bundle to the application.
However, Webpack also produces [JavaScript source maps](https://www.html5rocks.com/en/tutorials/developertools/sourcemaps/) to assist in the debugging and development process; when things go wrong, the browser's debugger can use the SourceMap to point to a line in the code that contains the issue at hand. Most developers do not adequately protect the source maps and ship them to production environments.
When the browser was simply handling an array of JavaScript files concatenated and (maybe) packed, this wasn't so much of an issue. However, developers of SPAs assume the use of JavaScript as an **intermediate representation**. Developers often expect production to contain obfuscated and/or otherwise-processed scripts, and do not understand just what the sourcemaps contain in many cases. This model aligns closely with shipping binaries: source is compiled and you ship the interpretable version. If this is the case, the sourcemap is akin to leaking your source alongside the "binary" (bundle) you have made. The bundle can be reverse engineered just as a binary can, but sourcemaps make this far easier.
## Usage
The script requires Python3, `BeautifulSoup4` and `requests`. Install dependencies with `pip3 install -r requirements.txt`. The script can handle downloaded sourcemaps, or attempt to parse them from remote sources for you. In all of these cases, we will assume that you have a directory you have created called `output` alongside the script:
```
\$ mkdir output
```
In order of increasing noisiness, to unpack a local sourcemap:
```
\$ ./unwebpack_sourcemap.py --local /path/to/source.map output
```
To unpack a remote sourcemap:
```
\$ ./unwebpack_sourcemap.py https://pathto.example.com/source.map output
```
To attempt to read all `` on an HTML page, fetch JS assets, look for `sourceMappingURI`, and pull sourcemaps from remote sources:
```
\$ ./unwebpack_sourcemap.py --detect https://pathto.example.com/spa_root/ output
```
## I'm a developer and this scares me. What do?
You have a few options:
1. Turn off sourcemaps in production entirely.
1. Push sourcemaps to a private server, and ACL sourcemap URIs to developers only.
1. Load sourcemaps from local sources only and do not push them to production.
## Example Vulnerable Application
An example TypeScript+React application is included in `example-react-ts-app`. You can run this locally and run the script against it.
## Contributions
This is an alpha-level script built for a series of engagements I was working on in which sourcemaps are disclosed in production environments. It currently is only meant to work with TypeScript+React and TypeScript+Vue templates. Pull requests to harden the script, make it read more sourcemaps, et cetera are greatly appreciated.
## License
MIT.