كيفية تثبيت Cyber Crucible

جدران الحماية تحظر وصول جهة إصدار الشهادات CRL/OCSP (وضع DMZ)

كيفية تثبيت Cyber Crucible


تثبيت Cyber Crucible سهل وبسيط. قم بتسجيل الدخول إلى تطبيق الويب على https://dashboard.cybercrucible.com

انتقل إلى صفحة العملاء (Agents)، وانقر على زر تنزيل العميل (Download Agent).

85131265.png?width=680

بعد النقر على الزر، ستظهر النافذة المنبثقة التالية:

85229569.png?width=340

اختر المجموعة التي تريد أن يظهر فيها العميل (أو العملاء) الذين تقوم بتثبيتهم في البداية.

إذا لم تظهر المجموعة في القائمة، فإما أن تحتاج إلى إنشاء المجموعة، أو أن تطلب من مسؤول المجموعة إضافتك إلى المجموعة الموجودة.

بعد التثبيت، يمكنك دائمًا تغيير المجموعة التي ينتمي إليها عميل واحد، أو عدة عملاء في وقت واحد. عادةً ما يكون من الأسهل تكوين عضوية المجموعة قبل النشر الجماعي، بدلاً من تنظيم العملاء بعد تثبيتهم.

الصلاحيات المطلوبة

يلزم الحصول على صلاحيات إدارية على الجهاز لتثبيت وتحميل خدمة ومحرك Cyber Crucible.

يقوم تثبيت النص البرمجي (Script) تحديدًا بتنزيل برنامج التثبيت وتكوينه إلى الموقع الافتراضي C:\. يجب تنفيذ النص البرمجي كمستخدم أو دور يملك صلاحية الوصول إلى موقع التنزيل والتنفيذ.

وبالتالي، يلزم إما مستخدم لديه صلاحية استخدام C:\ أثناء التثبيت، أو تعديل النص البرمجي (الموضح أدناه) لتنزيل التثبيت وتنفيذه في موقع مختلف.

التثبيت عبر واجهة المستخدم الرسومية (GUI)

تتيح طريقة التثبيت هذه للمستخدم تكوين وتثبيت عملية التثبيت يدويًا.

تتطلب طريقة التثبيت هذه مستخدمًا يملك صلاحيات التثبيت في المجموعة المحددة، ليتمكن من تسجيل الدخول.

يُفضَّل استخدامها لتثبيت جهاز واحد أو جهازين، بواسطة مستخدم واحد.

التثبيت عبر النص البرمجي (Script)

هذه هي طريقة التثبيت الأكثر شيوعًا بلا منازع.

باستخدام هذه الطريقة، يقوم تطبيق ويب Cyber Crucible تلقائيًا بتكوين عملية التثبيت، وتمهيد اتصال العميل الآمن بتطبيق الويب.

يُستخدم ملف Windows دفعي (Batch File). ورغم وجود طرق تثبيت أخرى أكثر تعقيدًا، إلا أن هذه الطريقة تتمتع بأوسع توافق مع أدوات الإدارة عن بُعد.

يمكن تشغيل الملف الدفعي كمستخدم يملك الصلاحيات المناسبة (عادةً المسؤول)، أو نسخه ولصقه في أداة النشر التلقائي المفضلة لديك.

فيما يلي فحص تقني لمحتويات الملف الدفعي، والذي يمكن تكوينه وفقًا لاحتياجاتك.

فحص تفصيلي لنص التثبيت البرمجي

يتم إدخال معرّف المجموعة المحدد أثناء إنشاء النص البرمجي في النص البرمجي، وكذلك رمز oauth المطلوب لانضمام العملاء إلى المجموعة المحددة.

47480849.png?width=680

يرجى ملاحظة أن رمز المصادقة oAuth هذا غير مرتبط بتطبيق الويب، ولا بأي مستخدم. ولا يمكن استخدامه لإجراء استدعاءات REST إلى واجهة برمجة تطبيقات (API) تطبيق الويب.

في بعض البيئات، قد يتم الحصول على الصلاحيات تلقائيًا. يحدث هذا عادةً في الحالات التي يقوم فيها المستخدم بتشغيل نص التثبيت البرمجي بالنقر عليه، مقارنةً بالوصول البرمجي. أما في بيئات المؤسسات أو أدوات النشر الآلي، فمن المحتمل ألا يتم تنفيذه.

47480857.png?width=680

في هذا الموقع التالي من النص البرمجي، يمكن تخصيص موقع الملف الذي يمكن تنزيل برنامج التثبيت وتنفيذه منه.

يُنصح بشدة بجعل هذا الموقع محليًا على الجهاز الذي يتم تثبيت الأداة عليه. فقيام عدة أجهزة بتنزيل برامج التثبيت إلى نفس الموقع سيؤدي إلى حدوث أعطال وكتابة فوق الملفات.

يرجى ملاحظة أن إعادة التشغيل التلقائية عبر نص التثبيت البرمجي لا تُستخدم افتراضيًا. والسبب في ذلك أن إعادة التشغيل الآلية في هذا النص البرمجي تفتقر إلى إدارة جدولة عمليات التثبيت في وقت محدد، وأساليب الإغلاق النظيف التي تتحقق مما إذا كان المستخدم مسجّل الدخول حاليًا أو يشغّل تطبيقات، أو تحذير المستخدم من إعادة تشغيل وشيكة.

47513621.png?width=680

يقوم هذا القسم التالي بتنزيل برنامج التثبيت وتسميته بشكل مخصص على الجهاز. يرجى ملاحظة أن التاريخ والوقت يُستخدمان لإضفاء طابع فريد على ملف التثبيت، في حال تنزيله عدة مرات بإعدادات أو إصدارات مختلفة.

Bitsadmin هي أداة مساعدة في Windows تحاول تنزيل الملفات دون التأثير سلبًا على الجهاز إذا كان نظام التشغيل تحت حمل ثقيل حاليًا.

47448109.png?width=680

في بعض البيئات يكون بروتوكول Bits معطلاً. بالإضافة إلى ذلك، قد يكون Bits في حالة غير تشغيلية بسبب خطأ في Windows. في حال فشل التنزيل عبر Bits، يستخدم القسم التالي طريقة بديلة (.net JSC) لتنزيل ملف برنامج التثبيت. لا يُنفَّذ هذا الرمز إلا إذا فشل تنزيل Bits السابق.

47415316.png?width=680

بعد تنزيل برنامج التثبيت، يقوم هذا القسم الأخير من النص البرمجي بتشغيل برنامج التثبيت. يرجى ملاحظة أنه يجب اختبار تخصيص وسيطات سطر الأوامر، للتأكد من أن إعدادات وحمايات installer.exe تتوافق مع وسيطات سطر الأوامر المقدمة هنا.

يرجى فتح تذكرة دعم إذا كانت هناك حاجة إلى إعدادات إضافية، أو للبيئات المتقدمة مثل إعدادات هجوم الوسيط عبر SSL (SSL man in the middle).

47480877.png?width=680

يرجى ملاحظة أن إعادة التشغيل ليست مطلوبة، وقد تم إلغاء تفعيلها من التنفيذ (بوضعها كتعليق). في حالات نادرة، وبشكل أكثر شيوعًا في الإصدارات الأقدم من Windows، لا تسجَّل برامج التشغيل (Drivers) وتُحمَّل في نظام التشغيل رغم توجيه برنامج التثبيت لها بذلك. في تلك الحالات، أسهل طريقة للتأكد من تحميل برنامج التشغيل هي تصدير العملاء إلى مستند Excel، والبحث عن أسماء الأجهزة المفقودة من قائمة أصولك. إذا كانت جميع عمليات التثبيت في مجموعة جديدة، يمكن أيضًا استخدام عدد العملاء.

47480889.png?width=680

هذا القسم في نهاية نص التثبيت البرمجي هو الدالة (Function) المستخدمة لتنزيل برنامج التثبيت باستخدام JSC إذا لزم الأمر. لا يتم تنفيذه إلا إذا تم الاستعانة بـ .net JSC لتنزيل برنامج التثبيت، كما في حال فشل Bits.

47480895.png?width=680

كيف يمكنني تحديد موقع سجلات التثبيت؟

تُخرج أدوات التثبيت من سطر الأوامر (CLI) بدون واجهة رسومية (Headless) حالتها وسجلاتها إلى كل من stdout وإلى ملف سجل، موجود في الدليل المحلي لملف exe الخاص بالمثبّت. بشكل افتراضي، عند استخدام نص برمجي مُعبأ مسبقًا، مثل نصوص ps1 أو bat التي يتم تنزيلها من https://dashboard.cybercrucible.com، سيكون ملف السجل موجودًا في جذر محرك الأقراص C:.

تُسمى ملفات سجل التثبيت cc_installer.log

لا تُنتج المثبّتات ذات الواجهة الرسومية (GUI) نفس ملفات السجل، حيث إنها ليست بدون واجهة (Headless)، وتُعرض جميع السجلات في القسم النصي القابل للتمرير في نافذة الواجهة الرسومية.

الدفع القسري للمثبّت إلى نطاق AD

في بعض البيئات الهشة، لا سيما عند التعافي من هجوم أو انقطاع حديث، قد لا يكون النشر العادي عبر RMM و/أو SCCM خيارًا متاحًا. ستجد هنا نصًا برمجيًا يمكن أن يكون بمثابة نموذج لكيفية دفع تثبيت CC قسريًا عبر بيئة active directory.

ملاحظة: من المرجح أن يحتاج هذا النص البرمجي إلى تخصيص وفقًا لحالة استخدامك، ويتطلب بيانات اعتماد النطاق (domain credentials) للتشغيل. من المتوقع أن يتم تشغيل هذا النص البرمجي مباشرة على وحدة تحكم النطاق (الأساسية).

خطوات التشغيل

  1. قم بتحديث المتغيّر $install_targets بقائمة أسماء الأجهزة (NETBIOS أو أسماء مضيف مشابهة)

  2. قم بتنزيل نص برمجي عادي للمثبّت بصيغة ps1 من لوحة تحكم Cyber Crucible

  3. قم بتحديث المتغيرات في النص البرمجي push_installer_ad.ps1 لتكون مطابقة لمتغيرات مجموعتك الخاصة من نص لوحة التحكم

    1. ${GroupId}

    2. ${ClientAuth}

    3. أي متغيرات --rest-pub-key

  4. قم بتنزيل ملف تنفيذي أصلي لواجهة سطر الأوامر (CLI) من لوحة تحكم Cyber Crucible

    1. ضع ملف CLI على مشاركة شبكية، أو في مكان يمكن الوصول إليه من جميع الأجهزة المراد تثبيتها عليها

      1. يمنع هذا كل جهاز من إهدار الوقت وعرض النطاق الترددي لإعادة تنزيل نفس الملف التنفيذي

      2. يمكن تنفيذ نفس الملف التنفيذي لأنظمة تشغيل مختلفة، حيث سيقوم المثبّت بسحب ملفات الخدمة/التعريف/التثبيت ذات الصلة بنظام التشغيل والدور المكتشفين للجهاز.

    2. قم بتعيين ${OutputFilePath إلى مسار ملف CLI على المشاركة الشبكية

  5. يمكن إزالة التحقق من الاتصال عبر ICMP (إذا لم يكن ضروريًا / غير صالح لبيئتك)

  6. قم بتشغيل النص البرمجي باستخدام -credential

    1. على سبيل المثال: ./push_installer_ad.ps1 -credential ad1\kyle

نظرة عامة على سكريبت التثبيت

  1. يتم تنزيل أحدث برنامج تثبيت من https://installerfiles.rpp.cybercrucible.com/installers/64/installer-cli.exe

    1. ستستخدم سكريبتات التثبيت من نوع PowerShell (PS1) نسخة WebClient.
      image-20240418-180132.png

    2. ستستخدم سكريبتات التثبيت من نوع Batch (BAT) أداة BitsAdmin، أو JScript إذا فشلت BitsAdmin.
      image-20240418-175009.png

  2. يتم تنفيذ برنامج التثبيت وتمرير معرّف المجموعة (group ID) وبيانات مصادقة العميل المتوفرة في السكريبت الخاص بك إليه.

    1. يمكن اختياريًا إضافة --reuse-agent-by-machine-name إلى عملية تنفيذ ملف exe، وذلك لجعل برنامج التثبيت يعيد استخدام كائن الوكيل (agent) والترخيص الخاص بوكيل تم تثبيته مسبقًا يحمل نفس اسم NetBIOS.

  3. يتحقق برنامج التثبيت من توفر شروط التثبيت المطلوبة

    1. التشغيل بصلاحيات المسؤول (Administrator).

    2. أن يعمل الجهاز بـإصدار مدعوم من Windows.

    3. عدم وجود برنامج تثبيت آخر قيد التشغيل بالفعل.

    4. عدم تثبيت الوكيل مسبقًا.

  4. يتحقق برنامج التثبيت من قدرة الجهاز على الاتصال بـالخوادم المطلوبة.

    1. Amazon oAuth 2.0 على العنوان ransomwarerewind-agents.auth.us-west-2.amazoncognito.com

    2. الخلفية (backend) الخاصة بـ Cyber Crucible على العنوان agent.tasking.rpp.cybercrucible.com

  5. يتم تنزيل ملفات الوكيل من installerfiles.rpp.cybercrucible.com عبر HTTPS.

  6. يتم تثبيت الوكيل وتشغيله.

التثبيت باستخدام SCCM

لا يختلف تثبيت Cyber Crucible باستخدام SCCM عن تثبيت أي حزمة برمجية أخرى. النقاط الأساسية للنشر عبر SCCM هي:

  1. انشر باستخدام سكربت PS1 الجاهز، الذي يتم تنزيله من https://dashboard.cybercrucible.com

  2. ابحث عن خدمة Cyber Crucible Agent قيد التشغيل، أو موجودة على القرص، كطريقة للكشف. الموقع الافتراضي لخدمة العميل هو C:\Program Files\CyberCrucible\service.exe

    1. اختياريًا، يمكنك أيضًا التحقق من وجود مفتاح التسجيل HKLM\Software\CyberCrucibleAgent، مع ملاحظة أنه بعد إلغاء التثبيت، قد يظل هذا المفتاح موجودًا.

خطوات التهيئة الافتراضية

  1. أنشئ تطبيقًا (Application)، وليس حزمة (package)

  2. حدد التهيئة يدويًا

image-20250807-175116.png

  1. قم بتهيئة اسم التطبيق، واسم المورّد، والوصف، وما إلى ذلك.

  2. قم بتهيئة نوع النشر (Deployment Type)، وحدد Script Installer

image-20250807-175303.pngimage-20250807-175332.png

  1. حدد موقع السكربت، على الأرجح مشاركة شبكية مثل \\cc-dc01\share\

  2. حدد برنامج التثبيت لتنفيذ ملف ps1 المرفق، مثال: Powershell.exe -file “CC-Install-Script-2025-8-7T13-55.ps1

    1. لاحظ الطابع الزمني للتاريخ في اسم السكربت، وقم بتغييره إلى التاريخ الخاص بك

    2. لا يُنصح بتجاوز سياسات PowerShell، ولكن اعتمادًا على تهيئتك، قد تحتاج إلى تحديد -executionpolicy Bypass أو ما شابه

  3. أضف طريقة كشف بالنقر على "Add Clause"

    1. راجع طرق الكشف الموصى بها في أعلى هذه الصفحة

  4. حدد إعدادات نشر تجربة المستخدم (UX)

    1. نظرًا لأن نشر Cyber Crucible لا يتطلب إعادة تشغيل، فإن متطلبات التثبيت وتسجيل الدخول تخضع لتقدير مؤسستك

image-20250807-175906.png

  1. اختر التالي / إنهاء حتى تتمكن من إغلاق المعالج.