
Electronegativity es una herramienta para identificar configuraciones incorrectas y antipatrones de seguridad en aplicaciones Electron.
⚠️ Este proyecto ha sido archivado ⚠️
¡Usa ElectroNG en su lugar!
Electronegativity es una herramienta para identificar configuraciones incorrectas y antipatrones de seguridad en aplicaciones basadas en Electron.
Aprovecha el análisis de AST y DOM para buscar configuraciones relevantes para la seguridad, tal como se describe en el whitepaper "Electron Security Checklist - A Guide for Developers and Auditors".
Los desarrolladores de software y los auditores de seguridad pueden usar esta herramienta para detectar y mitigar posibles debilidades y errores de implementación al desarrollar aplicaciones con Electron. Aún se requiere una buena comprensión de la (in)seguridad de Electron al usar Electronegativity, ya que algunos de los posibles problemas detectados por la herramienta requieren investigación manual.
Si te interesa la seguridad de Electron, echa un vistazo a nuestra investigación de BlackHat 2017 Electronegativity - A Study of Electron Security y mantente atento al blog de Doyensec.

Las versiones principales se publican en NPM y se pueden instalar simplemente usando:
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Opción | Descripción |
|---|---|
| -V | muestra el número de versión |
| -i, --input | entrada (directorio, .js, .html, .asar) |
| -l, --checks | ejecutar solo las comprobaciones especificadas, pasadas en formato csv |
| -x, --exclude-checks | omitir la lista de comprobaciones especificada, pasada en formato csv |
| -s, --severity | devolver solo los hallazgos con el nivel de severidad especificado o superior |
| -c, --confidence | devolver solo los hallazgos con el nivel de confianza especificado o superior |
| -o, --output <filename[.csv or .sarif]> | guardar los resultados en un archivo en formato csv o sarif |
| -r, --relative | mostrar la ruta relativa de los archivos |
| -v, --verbose | mostrar la descripción de los hallazgos, por defecto true |
| -u, --upgrade | ejecutar comprobaciones de actualización de Electron, p. ej. -u 7..8 para comprobar la actualización de Electron 7 a 8 |
| -e, --electron-version | asumir la versión de Electron establecida, sobrescribiendo la detectada, p. ej. -e 7.0.0 para tratarlo como si usara Electron 7 |
| -p, --parser-plugins | especificar plugins de analizador adicionales a usar separados por comas, p. ej. -p optionalChaining |
| -h, --help | mostrar información de uso |
Usar electronegativity para buscar problemas en un directorio que contiene una aplicación Electron:
$ electronegativity -i /path/to/electron/app
Usando la electronegatividad para buscar problemas en un archivo asar y guardando los resultados en un archivo csv:
$ electronegativity -i /path/to/asar/archive -o result.csv
Al usar la electronegatividad al actualizar de una versión de Electron a otra para encontrar cambios disruptivos:
$ electronegativity -i /path/to/electron/app -v -u 7..8
Nota: si te encuentras con el error fatal "JavaScript heap out of memory", puedes ejecutar node usando node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv
Electronegativity te permite deshabilitar comprobaciones individuales mediante comentarios eng-disable. Por ejemplo, si quieres que una comprobación específica ignore una línea de código, puedes deshabilitarla de la siguiente manera:
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Cualquier comentario en línea eng-disable (// eng-disable, /* eng-disable */, <!-- eng-disable -->) deshabilitará la comprobación especificada solo para esa línea. También es posible proporcionar varios nombres de comprobación usando tanto sus IDs en snake case (DANGEROUS_FUNCTIONS_JS_CHECK) como sus nombres de constructo (dangerousFunctionsJSCheck):
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Si colocas una directiva eng-disable antes de cualquier código al principio de un archivo .js o .html, eso deshabilitará las comprobaciones indicadas para el archivo completo.
eng-disableAntes de la v1.9.0, las comprobaciones globales no podían deshabilitarse mediante anotaciones de código. Si aún utilizas una versión antigua, usa el argumento CLI -x para deshabilitar manualmente una lista de comprobaciones (p. ej., -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Ten en cuenta que el uso de anotaciones puede no ser aplicable para algunas comprobaciones de nivel superior, como CSP_GLOBAL_CHECK o AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. En esos casos, es posible que quieras usar el flag -x para excluir comprobaciones específicas de tu escaneo.
Electronegativity Action puede ejecutarse como parte de tu pipeline de CI/CD de GitHub para obtener "alertas de escaneo de código":

También puedes usar electronegativity mediante programación, utilizando opciones similares a las de la 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));
El resultado contiene el número de comprobaciones globales y atómicas, cualquier error encontrado durante el análisis y un array de los problemas encontrados, así: