Cargo.toml هو الملف الذي يحتوي على التبعيات وإعدادات الترجمة.
main.rs هو الملف الرئيسي الذي سيتم ترجمته مع أي أدلة محتملة تحتوي على مكتبات.

لترجمة المشروع، انتقل إلى دليل المشروع ونفذ:  
`cargo build`

سيستخدم هذا سلسلة الأدوات الافتراضية الخاصة بك.
إذا كنت تريد بناء الإصدار النهائي "release"، نفذ:  
`cargo build --release`

للحصول على ملفات ثنائية ثابتة، في الطرفية قبل أمر البناء نفذ:  
`"C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"`  
`set RUSTFLAGS=-C target-feature=+crt-static`

إذا وجدت صعوبة في قراءة الكود بالطريقة التي كُتب بها،
يمكنك أيضًا استخدام الأمر التالي داخل دليل المشروع لتنسيقه بشكل أفضل  
`cargo fmt`

قد لا تترجم بعض الأمثلة وتعطيك خطأ، لأنها قد تتطلب إصدارًا ليليًا (nightly) من Rust بأحدث الميزات. لتثبيته فقط نفذ:  
`rustup default nightly`



أسهل مكان للعثور على التبعيات أو [Crates](https://crates.io/) كما تُسمى.

## الترجمة المتقاطعة (Cross Compiling)

تتطلب الترجمة المتقاطعة اتباع التعليمات [هنا](https://rust-lang.github.io/rustup/cross-compilation.html)
بتثبيت سلاسل أدوات مختلفة، يمكنك الترجمة المتقاطعة باستخدام الأمر التالي  
`cargo build --target <toolchain>`  

لعرض سلاسل الأدوات المثبتة على نظامك نفذ:  
`rustup toolchain list`  

للتحقق من جميع سلاسل الأدوات المتاحة التي يمكنك تثبيتها على نظامك نفذ:  
`rustup target list`  

لتثبيت سلسلة أدوات جديدة نفذ:  
`rustup target add <toolchain_name>`  


## تحسين الملفات التنفيذية من حيث الحجم

يحتوي هذا [المستودع](https://github.com/johnthagen/min-sized-rust) على العديد من خيارات التكوين والأفكار حول تقليل حجم الملف.
عادةً ما تكون الملفات الثنائية الثابتة كبيرة جدًا.

## المزالق التي وقعت فيها بنفسي

انتبه إلى بايتات \0، لا تنساها للسلاسل في الذاكرة، قضيت الكثير من وقتي لكن windbg ساعدت دائمًا في حلها.


## مكتبات Rust المثيرة للاهتمام

- WINAPI  
- [WINAPI2](https://github.com/MauriceKayser/rs-winapi2)  
- Windows - هذه هي المكتبة الرسمية من Microsoft التي لم أتعامل معها كثيرًا

## OPSEC

- على الرغم من أن Rust يتمتع بمزايا جيدة، إلا أنه من الصعب جدًا التعود عليه وليس بديهيًا جدًا.  
- توليد شيل كود هو مشكلة أخرى بسبب LLVM. لقد وجدت عدة طرق للتعامل مع هذا.  
[Donut](https://github.com/TheWover/donut) أحيانًا يولد شيل كود يعمل ولكن اعتمادًا على كيفية بناء المشروع، قد لا يعمل.  
بشكل عام، لتوليد شيل كود، يجب تصميم الأدوات بحيث تستضيف كل الكود في مقطع .text،
مما يؤدي إلى هذا [المستودع](https://github.com/b1tg/rust-windows-shellcode) الرائع.
يوجد نموذج شيل كود في هذا المشروع يمكن أن يوضح لك كيفية تنظيم الكود الخاص بك لتوليد شيل كود ناجح.  
بالإضافة إلى ذلك، يحتوي هذا المشروع أيضًا على مولد شيل كود يستخرج مقطع .text من ملف ثنائي
ويقوم بإخراج الشيل كود بعد تنفيذ بعض التصحيحات.  
هذا المشروع يأخذ الملف الثنائي من موقع محدد لذا قمت بعمل fork يتلقى مسار الملف الثنائي كوسيطة [هنا](https://github.com/trickster0/rust-windows-shellcode-custom).  
- حتى لو قمت بإزالة جميع رموز التصحيح، لا يزال Rust يمكنه الاحتفاظ بمراجع لدليلك الرئيسي في الملف الثنائي. الطريقة الوحيدة التي وجدتها لإزالة ذلك هي تمرير العلم التالي: `--remap-path-prefix {دليلك الرئيسي}={معرف عشوائي ما}`. يمكنك استخدام متغيرات bash للحصول على دليلك الرئيسي وتوليد عنصر نائب عشوائي: `--remap-path-prefix "$HOME"="$RANDOM"`. (بواسطة [Yamakadi](https://github.com/yamakadi))
- على الرغم من وجود طريقة أخرى لإزالة معلومات حول الدليل الرئيسي عن طريق إضافة السطر التالي في أعلى Cargo.toml  
`cargo-features = ["strip"]` .  
نظرًا لأن Rust يترك افتراضيًا الكثير من الأشياء كسلاسل في الملف الثنائي، فأنا أستخدم في الغالب هذا [cargo.toml](../master/cargo.toml) لتجنبها وتقليل الحجم أيضًا  
مع أمر البناء   
`cargo build --release -Z build-std=std,panic_abort -Z build-std-features=panic_immediate_abort --target x86_64-pc-windows-msvc`
- [Yamakadi] ، أشار أيضًا إلى أنه اعتمادًا على المكتبات المستوردة، فإن عملية strip ليست دائمًا متسقة في إخفاء الدليل الرئيسي، لذا فإن الجمع بين حله لإعادة تعيين المسار واستخدام cargo أعلاه سيكون الأفضل. حاول أن تكون على دراية وتفقد ملفاتك الثنائية قبل تنفيذها في مهامك للبحث عن سلاسل محتملة لم يتم strip بشكل صحيح.

## مشاريع أخرى قمت بها في Rust

- [UDPlant](https://github.com/trickster0/UDPlant) - ببساطة شيل عكسي UDP  
- [EDR Detector](https://github.com/trickster0/EDR_Detector) - يكتشف EDRs الخاصة بالنظام المثبت وفقًا لملفات .sys المثبتة  
- [Lenum](https://github.com/trickster0/Lenum) - أداة تعداد بسيطة لـ unix

## مشاريع في Rust قد تكون مفيدة

- [houdini](https://github.com/yamakadi/houdini) - يساعد في جعل ملفك التنفيذي يحذف نفسه