
Electronegativity est un outil pour identifier les mauvaises configurations et les anti-modèles de sécurité dans les applications Electron.
⚠️ Ce projet a été archivé ⚠️
Utilisez plutôt ElectroNG !
Electronegativity est un outil permettant d'identifier les erreurs de configuration et les anti-patterns de sécurité dans les applications basées sur Electron.
Il s'appuie sur l'analyse AST et DOM pour rechercher les configurations pertinentes en matière de sécurité, comme décrit dans le livre blanc "Electron Security Checklist - A Guide for Developers and Auditors".
Les développeurs de logiciels et les auditeurs de sécurité peuvent utiliser cet outil pour détecter et atténuer les faiblesses potentielles et les bugs d'implémentation lors du développement d'applications utilisant Electron. Une bonne compréhension de l'(in)sécurité d'Electron reste nécessaire lors de l'utilisation d'Electronegativity, car certains des problèmes potentiels détectés par l'outil nécessitent une investigation manuelle.
Si vous vous intéressez à la sécurité d'Electron, jetez un œil à nos recherches présentées à BlackHat 2017 Electronegativity - A Study of Electron Security et gardez un œil sur le blog de Doyensec.

Les versions majeures sont publiées sur NPM et peuvent être simplement installées à l'aide de :
$ npm install @doyensec/electronegativity -g
$ electronegativity -h
| Option | Description |
|---|---|
| -V | affiche le numéro de version |
| -i, --input | entrée (répertoire, .js, .html, .asar) |
| -l, --checks | exécute uniquement les vérifications spécifiées, transmises au format csv |
| -x, --exclude-checks | ignore la liste de vérifications spécifiée, transmise au format csv |
| -s, --severity | ne renvoie que les résultats dont le niveau de gravité est égal ou supérieur à celui spécifié |
| -c, --confidence | ne renvoie que les résultats dont le niveau de confiance est égal ou supérieur à celui spécifié |
| -o, --output <filename[.csv or .sarif]> | enregistre les résultats dans un fichier au format csv ou sarif |
| -r, --relative | affiche le chemin relatif des fichiers |
| -v, --verbose | affiche la description des résultats, par défaut true |
| -u, --upgrade | exécute les vérifications de mise à niveau d'Electron, par ex. -u 7..8 pour vérifier la mise à niveau d'Electron 7 vers 8 |
| -e, --electron-version | suppose la version d'Electron définie, en remplaçant celle détectée, par ex. -e 7.0.0 pour considérer l'utilisation d'Electron 7 |
| -p, --parser-plugins | spécifie des plugins d'analyse supplémentaires à utiliser, séparés par des virgules, par ex. -p optionalChaining |
| -h, --help | affiche les informations d'utilisation |
Utilisation d'electronegativity pour rechercher des problèmes dans un répertoire contenant une application Electron :
$ electronegativity -i /path/to/electron/app
Utiliser l'électronégativité pour rechercher des problèmes dans une archive asar et enregistrer les résultats dans un fichier csv :
$ electronegativity -i /path/to/asar/archive -o result.csv
En utilisant l'électronégativité lors de la mise à niveau d'une version d'Electron à une autre pour trouver les changements cassants :
$ electronegativity -i /path/to/electron/app -v -u 7..8
Remarque : si vous rencontrez l'erreur fatale « JavaScript heap out of memory », vous pouvez exécuter node en utilisant node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv
Electronegativity vous permet de désactiver des vérifications individuelles à l'aide de commentaires eng-disable. Par exemple, si vous souhaitez qu'une vérification spécifique ignore une ligne de code, vous pouvez la désactiver comme suit :
const res = eval(safeVariable); /* eng-disable DANGEROUS_FUNCTIONS_JS_CHECK */
<webview src="https://doyensec.com/" enableblinkfeatures="DangerousFeature"></webview> <!-- eng-disable BLINK_FEATURES_HTML_CHECK -->
Tout commentaire inline eng-disable (// eng-disable, /* eng-disable */, <!-- eng-disable -->) désactivera la vérification spécifiée pour cette seule ligne. Il est également possible de fournir plusieurs noms de vérification en utilisant à la fois leurs ID en snake case (DANGEROUS_FUNCTIONS_JS_CHECK) ou leurs noms de construction (dangerousFunctionsJSCheck) :
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
Si vous placez une directive eng-disable avant tout code en haut d'un fichier .js ou .html, cela désactivera les vérifications transmises pour le fichier entier.
eng-disableAvant la v1.9.0, les vérifications globales ne pouvaient pas être désactivées à l'aide d'annotations de code. Si vous utilisez encore une ancienne version, utilisez l'argument CLI -x pour désactiver manuellement une liste de vérifications (par exemple -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
Notez que l'utilisation d'annotations peut ne pas être applicable pour certaines vérifications de niveau supérieur telles que CSP_GLOBAL_CHECK ou AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. Dans ces cas, vous pouvez utiliser l'option -x pour exclure des vérifications spécifiques de votre analyse.
Electronegativity Action peut s'exécuter dans le cadre de votre pipeline CI/CD GitHub pour obtenir des « alertes d'analyse de code » :

Vous pouvez également utiliser electronegativity par programmation, en utilisant des options similaires à celles 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));
Découvrez les outils les plus utilisés par notre communauté.
Pas encore de données de popularité.