electron-hardener

A Rust library and command line tool to harden Electron binaries against runtime behavior modifications.

This provides a way to harden Electron applications against a specific class of runtime behavior modification. Specifically, if an unprivileged process can't write to the application's binary file or process address space, it should not be able to change what an app does at runtime.

The library provides two sets of functionality:

An interface to view and modify the status of fuses in an application, similar to the official fuses package.
A fast and configurable alternative implementation of the electron-evil-feature-patcher tool created by Dimitri Witkowski. All patches it can perform are also exposed in this crate. See its README for more details on how it works.

Usage

Library

The library exposes a simple and configurable interface:

use electron_hardener::{ElectronApp, Fuse, NodeJsCommandLineFlag};

let mut app = ElectronApp::from_bytes(&mut application_bytes)?;

app.set_fuse_status(Fuse::RunAsNode, false)?;

app.patch_option(NodeJsCommandLineFlag::Inspect)?;

Check out the command line tool's source or the example to see more ways to use it.

Command line tool

The command line tool exposes the same functionality and interface as electron-evil-feature-patcher:

electron-hardener ./path/to/packaged/electron/app

Install

Library

In your project's Cargo.toml file:

electron_hardener = "0.1

Command line tool

Make sure you have a Rust compiler installed and then run

cargo install electron-hardener

MSRV

The Minimum Supported Rust Version is currently 1.46.0. This will be bumped to the latest stable version of Rust when needed.

Credits

Made with ❤️ by the 1Password team, with full credits to Dimitri Witkowski for taking the time and effort to discover the command line flags that can be disabled, and finally creating the original tool which served as inspiration for this project.

License

^{Licensed under either of Apache License, Version 2.0 or MIT license at your option.}
_{Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.}

You might also like...

Releases(v0.2.2)

v0.2.2(Sep 22, 2021)
[0.2.2] - 2021-09-22

Changed

Updated minimum supported Electron version to 15.

Deprecated patching with NodeJsCommandLineFlag. This has been superseded by the NodeCliInspect fuse.

Deprecated patching with DevToolsMessage. It is no longer needed due to the functionality provided by the NodeCliInspect fuse.

New

Added support for Electron's experimental cookie encryption fuse added in version 13.

Added support for Electron's new fuses to disable NodeJS debugging flags and environment variables.

Added support for Electron's new ASAR integrity fuses to protect against unknown code from being ran.

Source code(tar.gz)
Source code(zip)
v0.2.1(Jun 2, 2021)

Source code(tar.gz)
Source code(zip)
v0.2.0(Jun 1, 2021)

Release v0.2.0 with support for Electron 13.
Source code(tar.gz)
Source code(zip)
v0.1.0(Apr 23, 2021)

Source code(tar.gz)
Source code(zip)