
Electronegativity é uma ferramenta para identificar configurações incorretas e anti-padrões de segurança em aplicações Electron.
⚠️ Este projeto foi arquivado ⚠️
Use o ElectroNG em vez disso!
Electronegativity é uma ferramenta para identificar configurações incorretas e antipadrões de segurança em aplicações baseadas em Electron.
Ele utiliza análise AST e DOM para procurar configurações relevantes para a segurança, conforme descrito no whitepaper "Electron Security Checklist - A Guide for Developers and Auditors".
Desenvolvedores de software e auditores de segurança podem usar esta ferramenta para detectar e mitigar possíveis vulnerabilidades e bugs de implementação ao desenvolver aplicações usando Electron. Ainda é necessário um bom entendimento da (in)segurança do Electron ao usar o Electronegativity, pois alguns dos possíveis problemas detectados pela ferramenta exigem investigação manual.
Se você tem interesse em Segurança do Electron, dê uma olhada em nossa pesquisa do BlackHat 2017 Electronegativity - A Study of Electron Security e fique de olho no blog da Doyensec.

As principais versões são publicadas no NPM e podem ser simplesmente instaladas usando:
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Opção | Descrição |
|---|---|
| -V | exibe o número da versão |
| -i, --input | entrada (diretório, .js, .html, .asar) |
| -l, --checks | executa apenas as verificações especificadas, passadas em formato csv |
| -x, --exclude-checks | ignora a lista de verificações especificada, passada em formato csv |
| -s, --severity | retorna apenas achados com o nível de severidade especificado ou superior |
| -c, --confidence | retorna apenas achados com o nível de confiança especificado ou superior |
| -o, --output <filename[.csv or .sarif]> | salva os resultados em um arquivo em formato csv ou sarif |
| -r, --relative | mostra o caminho relativo para os arquivos |
| -v, --verbose | mostra a descrição dos achados, o padrão é true |
| -u, --upgrade | executa verificações de atualização do Electron, ex.: -u 7..8 para verificar a atualização do Electron 7 para 8 |
| -e, --electron-version | assume a versão do Electron definida, substituindo a detectada, ex.: -e 7.0.0 para tratar como se estivesse usando o Electron 7 |
| -p, --parser-plugins | especifica plugins de parser adicionais a serem usados, separados por vírgulas, ex.: -p optionalChaining |
| -h, --help | exibe informações de uso |
Usando o electronegativity para procurar problemas em um diretório contendo um aplicativo Electron:
$ electronegativity -i /path/to/electron/app
Usando eletronegatividade para procurar problemas em um arquivo asar e salvar os resultados em um arquivo csv:
$ electronegativity -i /path/to/asar/archive -o result.csv
Ao atualizar de uma versão do Electron para outra, usar a eletronegatividade para encontrar alterações que quebram a compatibilidade:
$ electronegativity -i /path/to/electron/app -v -u 7..8
Nota: se você estiver encontrando o Erro Fatal "JavaScript heap out of memory", você pode executar o node usando node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv
O Electronegativity permite desativar verificações individuais usando comentários eng-disable. Por exemplo, se você quiser que uma verificação específica ignore uma linha de código, você pode desativá-la da seguinte forma:
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Qualquer comentário inline eng-disable (// eng-disable, /* eng-disable */, <!-- eng-disable -->) desativará a verificação especificada apenas para aquela linha. Também é possível fornecer vários nomes de verificação usando tanto seus IDs em snake case (DANGEROUS_FUNCTIONS_JS_CHECK) quanto seus nomes de construtor (dangerousFunctionsJSCheck):
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Se você colocar uma diretiva eng-disable antes de qualquer código no topo de um arquivo .js ou .html, isso desativará as verificações passadas para o arquivo inteiro.
eng-disableAntes da v1.9.0, as verificações globais não podiam ser desativadas usando anotações de código. Se você ainda estiver usando uma versão antiga, use o argumento de CLI -x para desativar manualmente uma lista de verificações (por exemplo, -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Observe que o uso de anotações pode não ser aplicável a algumas verificações de nível superior, como CSP_GLOBAL_CHECK ou AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. Nesses casos, você pode querer usar a flag -x para excluir verificações específicas da sua varredura.
A Electronegativity Action pode ser executada como parte do seu pipeline de CI/CD do GitHub para obter "alertas de varredura de código":

Você também pode usar o electronegativity programaticamente, usando opções semelhantes às da 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));
O resultado contém o número de verificações globais e atômicas, quaisquer erros encontrados durante a análise e um array dos problemas encontrados, assim: