
Electronegativity هي أداة لتحديد التكوينات الخاطئة وأنماط الأمن المضادة في تطبيقات Electron.
⚠️ تمت أرشفة هذا المشروع ⚠️
استخدم ElectroNG بدلاً من ذلك!
Electronegativity هي أداة لتحديد سوء التكوين وأنماط الأمان المضادة في التطبيقات المبنية على Electron.
تستفيد من تحليل AST وDOM للبحث عن التكوينات ذات الصلة بالأمان، كما هو موضح في الورقة البيضاء "Electron Security Checklist - A Guide for Developers and Auditors".
يمكن لمطوري البرمجيات ومدققي الأمان استخدام هذه الأداة لاكتشاف وتخفيف نقاط الضعف المحتملة وأخطاء التنفيذ عند تطوير التطبيقات باستخدام Electron. لا يزال الفهم الجيد لـ (عدم) أمان Electron مطلوبًا عند استخدام Electronegativity، حيث تتطلب بعض المشكلات المحتملة التي تكتشفها الأداة تحقيقًا يدويًا.
إذا كنت مهتمًا بأمان 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 لم يكن بالإمكان تعطيل الفحوصات العامة باستخدام توجيهات الشيفرة. إذا كنت لا تزال تستخدم إصدارًا قديمًا، فاستخدم وسيط سطر الأوامر -x لتعطيل قائمة من الفحوصات يدويًا بدلًا من ذلك (مثل -x LimitNavigationJsCheck,PermissionRequestHandlerJsCheck,CSPGlobalCheck).
لاحظ أن استخدام التوجيهات قد لا يكون مناسبًا لبعض الفحوصات عالية المستوى مثل CSP_GLOBAL_CHECK أو AVAILABLE_SECURITY_FIXES_GLOBAL_CHECK. في تلك الحالات، قد ترغب في استخدام العلامة -x لاستبعاد فحوصات محددة من الفحص الخاص بك.
قد يعمل Electronegativity Action كجزء من خط أنابيب CI/CD الخاص بك على GitHub للحصول على "تنبيهات فحص الشيفرة":

يمكنك أيضًا استخدام 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));
تحتوي النتيجة على عدد الفحوصات العامة والذرية، وأي أخطاء واجهتها أثناء التحليل، ومصفوفة بالمشكلات التي تم العثور عليها، على النحو التالي:
{
globalChecks: 6,
atomicChecks: 36,
errors: [
{
file: 'ts/main/main.ts',
sample: 'shell.openExternal(url);',
location: { line: 328, column: 4 },
id: 'OPEN_EXTERNAL_JS_CHECK',
description: 'Review the use of openExternal',
properties: undefined,
severity: { value: 2, name: 'MEDIUM', format: [Function: format] },
confidence: { value: 0, name: 'TENTATIVE', format: [Function: format] },
manualReview: true,
shortenedURL: 'https://git.io/JeuMC'
},
{
file: 'ts/main/main.ts',
sample: 'const popup = new BrowserWindow(options);',
location: { line: 340, column: 18 },
id: 'CONTEXT_ISOLATION_JS_CHECK',
description: 'Review the use of the contextIsolation option',
properties: undefined,
severity: { value: 3, name: 'HIGH', format: [Function: format] },
confidence: { value: 1, name: 'FIRM', format: [Function: format] },
manualReview: false,
shortenedURL: 'https://git.io/Jeu1p'
}
]
}