
Электроотрицательность — это инструмент для выявления неверных конфигураций и антипаттернов безопасности в приложениях Electron.
⚠️ Этот проект был архивирован ⚠️
Вместо него используйте ElectroNG!
Electronegativity — это инструмент для выявления ошибок конфигурации и антипаттернов безопасности в приложениях на основе Electron.
Он использует разбор AST и DOM для поиска конфигураций, значимых для безопасности, как описано в техническом документе "Electron Security Checklist - A Guide for Developers and Auditors".
Разработчики программного обеспечения и аудиторы безопасности могут использовать этот инструмент для обнаружения и устранения потенциальных слабых мест и ошибок реализации при разработке приложений на Electron. При использовании Electronegativity по-прежнему требуется хорошее понимание (не)безопасности Electron, поскольку некоторые из потенциальных проблем, обнаруживаемых инструментом, требуют ручного исследования.
Если вас интересует безопасность Electron, ознакомьтесь с нашим исследованием BlackHat 2017 Electronegativity - A Study of Electron Security и следите за блогом Doyensec.

Основные релизы публикуются в NPM и могут быть просто установлены с помощью:
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Опция | Описание |
|---|---|
| -V | вывести номер версии |
| -i, --input | входные данные (каталог, .js, .html, .asar) |
| -l, --checks | запускать только указанные проверки, переданные в формате csv |
| -x, --exclude-checks | пропустить указанный список проверок, переданный в формате csv |
| -s, --severity | возвращать только находки с указанным уровнем серьёзности или выше |
| -c, --confidence | возвращать только находки с указанным уровнем достоверности или выше |
| -o, --output <filename[.csv or .sarif]> | сохранить результаты в файл в формате csv или sarif |
| -r, --relative | показывать относительный путь для файлов |
| -v, --verbose | показывать описание находок, по умолчанию true |
| -u, --upgrade | запустить проверки обновления Electron, например -u 7..8 для проверки обновления с Electron 7 до 8 |
| -e, --electron-version | принять заданную версию Electron, переопределяя обнаруженную, например -e 7.0.0, чтобы считать используемой версию Electron 7 |
| -p, --parser-plugins | указать дополнительные плагины парсера через запятую, например -p optionalChaining |
| -h, --help | вывести информацию об использовании |
Использование electronegativity для поиска проблем в каталоге, содержащем приложение Electron:
$ electronegativity -i /path/to/electron/app
Использование электроотрицательности для поиска проблем в архиве asar и сохранение результатов в csv-файл:
$ electronegativity -i /path/to/asar/archive -o result.csv
При использовании электроотрицательности при обновлении с одной версии Electron на другую для поиска критических изменений:
$ electronegativity -i /path/to/electron/app -v -u 7..8
Примечание: если вы столкнулись с фатальной ошибкой «JavaScript heap out of memory», можно запустить node с параметром node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv
Electronegativity позволяет отключать отдельные проверки с помощью комментариев eng-disable. Например, если вы хотите, чтобы конкретная проверка игнорировала строку кода, её можно отключить следующим образом:
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Любой встроенный комментарий eng-disable (// eng-disable, /* eng-disable */, <!-- eng-disable -->) отключит указанную проверку только для этой строки. Также можно указать несколько имён проверок, используя как их идентификаторы в snake case (DANGEROUS_FUNCTIONS_JS_CHECK), так и их имена конструкций (dangerousFunctionsJSCheck):
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Если вы поместите директиву eng-disable перед любым кодом в начале файла .js или .html, это отключит указанные проверки для всего файла.
eng-disableДо версии v1.9.0 глобальные проверки нельзя было отключить с помощью аннотаций в коде. Если вы всё ещё используете старую версию, используйте аргумент CLI -x, чтобы вручную отключить список проверок (например, -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Обратите внимание, что использование аннотаций может быть неприменимо для некоторых проверок более высокого уровня, таких как CSP_GLOBAL_CHECK или AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. В таких случаях вы можете использовать флаг -x, чтобы исключить определённые проверки из сканирования.
Electronegativity Action может запускаться в составе вашего конвейера GitHub CI/CD для получения «оповещений сканирования кода»:

Вы также можете использовать electronegativity программно, с параметрами, аналогичными тем, что используются для 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));
Результат содержит количество глобальных и атомарных проверок, любые ошибки, возникшие при разборе, и массив найденных проблем, например: