
Electronegativity एक उपकरण है जो इलेक्ट्रॉन अनुप्रयोगों में गलत कॉन्फ़िगरेशन और सुरक्षा विरोध-पैटर्न की पहचान करने के लिए है।
⚠️ यह प्रोजेक्ट संग्रहीत (archived) कर दिया गया है ⚠️
इसके बजाय 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 | उपयोग करने के लिए अतिरिक्त parser प्लगइन निर्दिष्ट करें, अल्पविराम से अलग, जैसे -p optionalChaining |
| -h, --help | उपयोग जानकारी आउटपुट करें |
Electron ऐप वाली निर्देशिका में समस्याओं को खोजने के लिए electronegativity का उपयोग करना:
$ electronegativity -i /path/to/electron/app
asar संग्रह में समस्याओं को खोजने के लिए विद्युतऋणात्मकता का उपयोग करना और परिणामों को csv फ़ाइल में सहेजना:
$ electronegativity -i /path/to/asar/archive -o result.csv
एक Electron संस्करण से दूसरे में अपग्रेड करते समय ब्रेकिंग परिवर्तनों को खोजने के लिए electronegativity का उपयोग करना:
$ electronegativity -i /path/to/electron/app -v -u 7..8
नोट: यदि आपको "JavaScript heap out of memory" त्रुटि आ रही है, तो आप node --max-old-space-size=4096 electronegativity -i /path/to/asar/archive -o result.csv का उपयोग करके node चला सकते हैं।
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 IDs (DANGEROUS_FUNCTIONS_JS_CHECK) या उनके construct नामों (dangerousFunctionsJSCheck) दोनों का उपयोग करके एकाधिक जाँच नाम प्रदान करना भी संभव है:
shell.openExternal(eval(safeVar)); /* eng-disable OPEN_EXTERNAL_JS_CHECK DANGEROUS_FUNCTIONS_JS_CHECK */
यदि आप किसी .js या .html फ़ाइल के शीर्ष पर किसी भी कोड से पहले eng-disable निर्देश डालते हैं, तो यह पूरी फ़ाइल के लिए पास किए गए चेक को अक्षम कर देगा।
eng-disable एनोटेशन पर नोटv1.9.0 से पहले ग्लोबल चेक को कोड एनोटेशन का उपयोग करके अक्षम नहीं किया जा सकता था। यदि आप अभी भी पुराना संस्करण उपयोग कर रहे हैं, तो चेक की सूची को मैन्युअल रूप से अक्षम करने के लिए -x CLI आर्ग्युमेंट का उपयोग करें (जैसे -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck)।
ध्यान दें कि एनोटेशन का उपयोग कुछ उच्च-स्तरीय चेक जैसे CSP_GLOBAL_CHECK या AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK के लिए लागू नहीं हो सकता है। उन मामलों के लिए, आप अपने स्कैन से विशिष्ट चेक को बाहर करने के लिए -x फ़्लैग का उपयोग करना चाह सकते हैं।
Electronegativity Action आपकी GitHub CI/CD पाइपलाइन के भाग के रूप में "Code scanning alerts" प्राप्त करने के लिए चल सकता है:

आप CLI के समान विकल्पों का उपयोग करके electronegativity को प्रोग्रामेटिक रूप से भी उपयोग कर सकते हैं:
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));
परिणाम में वैश्विक और परमाणु जाँचों की संख्या, पार्सिंग के दौरान आई कोई भी त्रुटियाँ, और पाई गई समस्याओं की एक सरणी होती है, जैसे: