
Elettronegatività è uno strumento per identificare configurazioni errate e anti-pattern di sicurezza nelle applicazioni Electron.
⚠️ Questo progetto è stato archiviato ⚠️
Usa invece ElectroNG!
Electronegativity è uno strumento per identificare misconfigurazioni e anti-pattern di sicurezza nelle applicazioni basate su Electron.
Sfrutta il parsing AST e DOM per cercare configurazioni rilevanti per la sicurezza, come descritto nel whitepaper "Electron Security Checklist - A Guide for Developers and Auditors".
Gli sviluppatori software e i revisori di sicurezza possono utilizzare questo strumento per rilevare e mitigare potenziali debolezze e bug di implementazione durante lo sviluppo di applicazioni con Electron. Quando si utilizza Electronegativity è comunque necessaria una buona comprensione della (in)sicurezza di Electron, poiché alcuni dei potenziali problemi rilevati dallo strumento richiedono un'indagine manuale.
Se sei interessato alla sicurezza di Electron, dai un'occhiata alla nostra ricerca per il BlackHat 2017 Electronegativity - A Study of Electron Security e tieni d'occhio il blog di Doyensec.

Le versioni principali vengono pubblicate su NPM e possono essere semplicemente installate usando:
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Opzione | Descrizione |
|---|---|
| -V | mostra il numero di versione |
| -i, --input | input (directory, .js, .html, .asar) |
| -l, --checks | esegue solo i controlli specificati, passati in formato csv |
| -x, --exclude-checks | salta l'elenco di controlli specificato, passato in formato csv |
| -s, --severity | restituisce solo i risultati con il livello di gravità specificato o superiore |
| -c, --confidence | restituisce solo i risultati con il livello di affidabilità specificato o superiore |
| -o, --output <filename[.csv or .sarif]> | salva i risultati in un file in formato csv o sarif |
| -r, --relative | mostra il percorso relativo per i file |
| -v, --verbose | mostra la descrizione dei risultati, valore predefinito true |
| -u, --upgrade | esegue i controlli di aggiornamento di Electron, ad es. -u 7..8 per verificare l'aggiornamento da Electron 7 a 8 |
| -e, --electron-version | assume la versione di Electron impostata, sovrascrivendo quella rilevata, ad es. -e 7.0.0 per trattare come se si utilizzasse Electron 7 |
| -p, --parser-plugins | specifica plugin parser aggiuntivi da usare separati da virgole, ad es. -p optionalChaining |
| -h, --help | mostra le informazioni sull'utilizzo |
Utilizzo di electronegativity per cercare problemi in una directory contenente un'app Electron:
$ electronegativity -i /path/to/electron/app
Utilizzo dell'elettronegatività per cercare problemi in un archivio asar e salvare i risultati in un file csv:
$ electronegativity -i /path/to/asar/archive -o result.csv
Utilizzo dell'elettronegatività durante l'aggiornamento da una versione di Electron a un'altra per individuare modifiche che causano incompatibilità:
$ electronegativity -i /path/to/electron/app -v -u 7..8
Nota: se si incontra l'errore fatale "JavaScript heap out of memory", è possibile eseguire node usando node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv
Electronegativity consente di disabilitare singoli controlli utilizzando i commenti eng-disable. Ad esempio, se si desidera che un controllo specifico ignori una riga di codice, è possibile disabilitarlo come segue:
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Qualsiasi commento inline eng-disable (// eng-disable, /* eng-disable */, <!-- eng-disable -->) disabiliterà il controllo specificato solo per quella riga. È anche possibile fornire più nomi di controllo utilizzando sia i loro ID in snake case (DANGEROUS_FUNCTIONS_JS_CHECK) sia i loro nomi di costrutto (dangerousFunctionsJSCheck):
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Se si inserisce una direttiva eng-disable prima di qualsiasi codice all'inizio di un file .js o .html, questa disabiliterà i controlli specificati per l'intero file.
eng-disablePrima della v1.9.0 i controlli globali non potevano essere disabilitati tramite annotazioni nel codice. Se si utilizza ancora una versione precedente, usare l'argomento CLI -x per disabilitare manualmente un elenco di controlli (ad es. -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Si noti che l'uso delle annotazioni potrebbe non essere applicabile per alcuni controlli di livello superiore come CSP_GLOBAL_CHECK o AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. In questi casi, potrebbe essere necessario utilizzare il flag -x per escludere controlli specifici dalla scansione.
Electronegativity Action può essere eseguita come parte della pipeline CI/CD di GitHub per ottenere "Code scanning alerts":

È inoltre possibile utilizzare electronegativity programmaticamente, con opzioni simili a quelle della 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));
Il risultato contiene il numero di controlli globali e atomici, eventuali errori riscontrati durante l'analisi e un array dei problemi trovati, come questo: