⭐ secure-vm
🧪 Experimental vm()
based on iframe for frontend (electron, micro apps, etc).
🇺🇸 | 🇨🇳
❓ What can it do?
👻 It can...
📃 Getting Started
🔽 Install
🦊 npm, yarn & pnpm, etc.
npm install secure-vm
yarn add secure-vm
pnpm install seucre-vm
👾 IIFE (not recommended)
<script src="https://cdn.jsdelivr.net/npm/secure-vm@latest/dist/index.global.js"></script>
<script>
const ctx = SecureVM.vm()
</script>
✅ Usage
import { vm } from 'secure-vm'
const ctx = vm()
ctx.console = globalThis.console
ctx.eval(`
console.log("Hello secure-vm")
`)
🐺 Compatibility
☣️ This is an experimental library that may be incompatible with some old browser kernels (for example, Opera). However, it works on latest versions of Chromium, Firefox, Edge and Safari.
💫 Try it out by yourself: (Demo not ready)
🛠️ Features
🔰 Ease to use
✅ To create a simple isolation, you only have to use a simple function, vm .
const ctx = vm()
👽 You can bypass almost everything to your sandbox and it will work properly, for example, Promise . (Some functions like ArrayBuffer may not work properly for unknown reasons)
const ctx = vm({ console })
let callback
ctx.test = new Promise(resolve => {
callback = resolve
})
ctx.eval(`
test.then(value => {
console.log(value)
})
`)
callback('Hello World!')
|
🔒 Security
🥰 Feel free to add anything you want, Function (constructor ) is gonna be safe.
secure-vm also fixed almost all security issues on evel, for example, Object.prototype bypass will fail.
ctx.fetch = fetch
ctx.console = console
fetch('some furry pics')
.then(
ctx.eval(`
req => {
console.log(req)
return req.text()
}
`)
)
.then(v => {
console.log(v)
})
🤖 Dynamic import() is disabled, so you do not need to worry about import bypass. See issue from evel.
Maybe we can run these code by using babel hacks, but we don't care.
import('data:text/javascript,console.log(window)')
|
🤔 Obfuscation
🔏 secure-vm will automatically erase the traceback line info (if available) so hackers cannot access source code, making it harder to deobfuscate.
ctx.eval(`
function throwError() {
throw new Error('Where is it?')
}
throwError() // throwError() will not be displayed in the DevTools traceback (Edge, Chromium, Firefox).
`)
|
🎨 Customization
😎 You can customize global objects by:
const ctx = vm({ WebAssembly })
ctx.
...or use our default whitelist by:
const ctx = vm()
|
This project is licensed under the MIT license.
❤️