
Electronegativity ist ein Tool zur Identifizierung von Fehlkonfigurationen und Sicherheits-Anti-Patterns in Electron-Anwendungen.
⚠️ Dieses Projekt wurde archiviert ⚠️
Verwenden Sie stattdessen ElectroNG!
Electronegativity ist ein Tool zur Identifizierung von Fehlkonfigurationen und Sicherheits-Anti-Patterns in Electron-basierten Anwendungen.
Es nutzt AST- und DOM-Parsing, um nach sicherheitsrelevanten Konfigurationen zu suchen, wie sie im Whitepaper "Electron Security Checklist - A Guide for Developers and Auditors" beschrieben sind.
Softwareentwickler und Sicherheitsauditoren können dieses Tool verwenden, um potenzielle Schwachstellen und Implementierungsfehler bei der Entwicklung von Anwendungen mit Electron zu erkennen und zu beheben. Ein gutes Verständnis der Electron-(Un-)Sicherheit ist bei der Verwendung von Electronegativity weiterhin erforderlich, da einige der vom Tool erkannten potenziellen Probleme manuelle Untersuchungen erfordern.
Wenn Sie sich für Electron-Sicherheit interessieren, werfen Sie einen Blick auf unsere BlackHat 2017-Forschung Electronegativity - A Study of Electron Security und behalten Sie den Doyensec-Blog im Auge.

Hauptversionen werden auf NPM veröffentlicht und können einfach installiert werden mit:
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Option | Beschreibung |
|---|---|
| -V | Versionsnummer ausgeben |
| -i, --input | Eingabe (Verzeichnis, .js, .html, .asar) |
| -l, --checks | nur die angegebenen Prüfungen ausführen, im CSV-Format übergeben |
| -x, --exclude-checks | die angegebene Prüfliste überspringen, im CSV-Format übergeben |
| -s, --severity | nur Befunde mit dem angegebenen Schweregrad oder höher zurückgeben |
| -c, --confidence | nur Befunde mit dem angegebenen Konfidenzniveau oder höher zurückgeben |
| -o, --output <filename[.csv or .sarif]> | die Ergebnisse in einer Datei im CSV- oder SARIF-Format speichern |
| -r, --relative | relativen Pfad für Dateien anzeigen |
| -v, --verbose | die Beschreibung für die Befunde anzeigen, standardmäßig true |
| -u, --upgrade | Electron-Upgrade-Prüfungen ausführen, z. B. -u 7..8, um das Upgrade von Electron 7 auf 8 zu prüfen |
| -e, --electron-version | die festgelegte Electron-Version annehmen und die erkannte überschreiben, z. B. -e 7.0.0, um die Verwendung von Electron 7 anzunehmen |
| -p, --parser-plugins | zusätzliche zu verwendende Parser-Plugins durch Kommas getrennt angeben, z. B. -p optionalChaining |
| -h, --help | Nutzungsinformationen ausgeben |
Electronegativity verwenden, um in einem Verzeichnis mit einer Electron-App nach Problemen zu suchen:
$ electronegativity -i /path/to/electron/app
Verwendung der Elektronegativität, um nach Problemen in einem asar-Archiv zu suchen und die Ergebnisse in einer CSV-Datei zu speichern:
$ electronegativity -i /path/to/asar/archive -o result.csv
Wenn Sie beim Upgrade von einer Electron-Version auf eine andere die Elektronegativität nutzen, um Breaking Changes zu finden:
$ electronegativity -i /path/to/electron/app -v -u 7..8
Hinweis: Wenn der schwerwiegende Fehler „JavaScript heap out of memory“ auftritt, können Sie node mit node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv ausführen.
Electronegativity ermöglicht es Ihnen, einzelne Prüfungen mithilfe von eng-disable-Kommentaren zu deaktivieren. Wenn Sie beispielsweise möchten, dass eine bestimmte Prüfung eine Codezeile ignoriert, können Sie sie wie folgt deaktivieren:
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Jeder eng-disable-Inline-Kommentar (// eng-disable, /* eng-disable */, <!-- eng-disable -->) deaktiviert die angegebene Prüfung nur für diese Zeile. Es ist auch möglich, mehrere Prüfungsnamen anzugeben, sowohl über ihre Snake-Case-IDs (DANGEROUS_FUNCTIONS_JS_CHECK) als auch über ihre Konstruktnamen (dangerousFunctionsJSCheck):
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Wenn Sie eine eng-disable-Direktive vor jeglichem Code am Anfang einer .js- oder .html-Datei platzieren, werden die übergebenen Prüfungen für die gesamte Datei deaktiviert.
eng-disable-AnnotationenVor v1.9.0 konnten globale Prüfungen nicht über Code-Annotationen deaktiviert werden. Wenn Sie noch eine ältere Version verwenden, nutzen Sie das CLI-Argument -x, um eine Liste von Prüfungen manuell zu deaktivieren (z. B. -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Beachten Sie, dass die Verwendung von Annotationen für einige übergeordnete Prüfungen wie CSP_GLOBAL_CHECK oder AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK möglicherweise nicht anwendbar ist. In diesen Fällen möchten Sie möglicherweise das Flag -x verwenden, um bestimmte Prüfungen von Ihrem Scan auszuschließen.
Electronegativity Action kann als Teil Ihrer GitHub-CI/CD-Pipeline ausgeführt werden, um „Code scanning alerts“ zu erhalten:

Sie können electronegativity auch programmatisch verwenden, mit ähnlichen Optionen wie für die CLI:
const run = require('@doyensec/electronegativity')
// or: import run from '@doyensec/electronegativity';
run({
// input (directory, .js, .html, .asar)
input: '/path/to/electron/app',
// save the results to a file in csv or sarif format (optional)
output: '/path/for/output/file',
// true to save output as sarif, false to save as csv (optional)
isSarif: false,
// only run the specified checks (optional)
customScan: ['dangerousfunctionsjscheck', 'remotemodulejscheck'],
// only return findings with the specified level of severity or above (optional)
severitySet: 'high',
// only return findings with the specified level of confidence or above (optional)
confidenceSet: 'certain',
// show relative path for files (optional)
isRelative: false,
// run Electron upgrade checks, eg -u 7..8 to check upgrade from Electron 7 to 8 (optional)
electronUpgrade: '7..8',
// assume the set Electron version, overriding the detected one
electronVersion: '5.0.0',
// use additional parser plugins
parserPlugins: ['optionalChaining']
})
.then(result => console.log(result))
.catch(err => console.error(err));
Das Ergebnis enthält die Anzahl der globalen und atomaren Prüfungen, alle beim Parsen aufgetretenen Fehler sowie ein Array der gefundenen Probleme, etwa so:
Entdecken Sie die meistgenutzten Tools unserer Community.
Noch keine Beliebtheitsdaten.