لأي استدعاءات معقدة لواجهة برمجة تطبيقات Windows، استخدم مكتبة [Winim](https://github.com/khchen/winim)، فهي توفر وقتًا هائلًا ولا تزيد حجم الملف التنفيذي كثيرًا (انظر أدناه) اعتمادًا على كيفية استيرادها.

حتى أنها تدعم COM!!!

## إنشاء مكتبات DLL لنظام Windows مع دالة `DllMain` مصدّرة

شكر كبير للشخص الذي نشر [هذا](https://forum.nim-lang.org/t/1973) في منتدى Nim.

يحاول مترجم Nim إنشاء دالة `DllMain` تلقائيًا لك في وقت الترجمة عندما تطلب منه إنشاء مكتبة DLL لنظام Windows، لكنه مع ذلك لا يقوم بتصديرها لسبب ما. لكي تحصل على دالة `DllMain` مصدّرة، تحتاج إلى تمرير `--nomain` وتعريف دالة `DllMain` بنفسك مع التوجيهات المناسبة (`stdcall, exportc, dynlib`).

تحتاج أيضًا إلى استدعاء `NimMain` من داخل `DllMain` الخاصة بك لتهيئة جامع القمامة في Nim. (مهم جدًا، وإلا سينفجر جهاز الكمبيوتر الخاص بك حرفيًا).

مثال:```nim
import winim/lean

proc NimMain() {.cdecl, importc.}

proc DllMain(hinstDLL: HINSTANCE, fdwReason: DWORD, lpvReserved: LPVOID) : BOOL {.stdcall, exportc, dynlib.} =
  NimMain()
  
  if fdwReason == DLL_PROCESS_ATTACH:
    MessageBox(0, "Hello, world !", "Nim is Powerful", 0)

  return true

### إنشاء ملفات XLL
يمكنك إنشاء ملف XLL (ملف Excel DLL، تخيل ذلك) مع auto open function يمكن استخدامها لتوصيل الـ payload. ينشئ الكود التالي ملف XLL بسيطًا يحتوي على auto open function وجميع الكود الأساسي اللازم لتجميعه كمكتبة link library. يتم تجميع POC كـ DLL، ثم يمكنك تغيير الامتداد إلى .xll وسيفتح في Excel ويشغل الـ payload عند النقر المزدوج:```nim
#[
    Compile:
        nim c -d=mingw --app=lib --nomain --cpu=amd64 nim_xll.nim
        
    Will compile as a DLL, you can then just change the extension to .xll
]#

import winim/lean

proc xlAutoOpen() {.stdcall, exportc, dynlib.} =
    MessageBox(0, "Hello, world !", "Nim is Powerful", 0)

proc NimMain() {.cdecl, importc.}

proc DllMain(hinstDLL: HINSTANCE, fdwReason: DWORD, lpvReserved: LPVOID) : BOOL {.stdcall, exportc, dynlib.} =
  NimMain()

  return true

## الفرق في حجم الملف التنفيذي عند استخدام مكتبة Winim مقارنة بعدم استخدامها

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

تم إنشاء المثالين `pop_bin.nim` و `pop_winim_bin.nim` لهذا الغرض.

الأول يعرّف استدعاء WinAPI الخاص بـ `MessageBox` يدويًا، بينما يستخدم الثاني مكتبة Winim (تحديدًا `winim/lean` وهي فقط جوهر SDK، انظر [هنا](https://github.com/khchen/winim#usage))، النتائج:```
byt3bl33d3r@ecl1ps3 OffensiveNim % ls -lah bin
-rwxr-xr-x  1 byt3bl33d3r  25K Nov 20 18:32 pop_bin_32.exe
-rwxr-xr-x  1 byt3bl33d3r  32K Nov 20 18:32 pop_bin_64.exe
-rwxr-xr-x  1 byt3bl33d3r  26K Nov 20 18:33 pop_winim_bin_32.exe
-rwxr-xr-x  1 byt3bl33d3r  34K Nov 20 18:32 pop_winim_bin_64.exe

## اعتبارات Opsec

نظرًا لكيفية قيام Nim بحل DLLs ديناميكيًا باستخدام `LoadLibrary` باستخدام FFI الخاصة بها، لن تظهر أي من وظائفك المستوردة خارجيًا في الاستيرادات الثابتة للملف التنفيذي (انظر [منشور المدونة هذا](https://web.archive.org/web/20210117002945/https://secbytes.net/implant-roulette-part-1:-nimplant/) لمزيد من التفاصيل):

![](https://assets.kitploit.com/production/public/readmes/6566/ae35b71c435c8fe24112a95abb0eca863721c9fde9b14efb7d4f2701bb57b3b9.png)

إذا قمت بتجميع كود Nim المصدر إلى DLL، يبدو أنه سيكون لديك دائمًا `NimMain` مصدرة، بغض النظر عن تحديد `DllMain` الخاص بك أم لا (؟؟). قد يُستخدم هذا كتوقيع، لا أعرف كم عدد الشركات التي تستخدم Nim فعليًا في مجموعة تطويرها. بالتأكيد يبرز.

![](https://assets.kitploit.com/production/public/readmes/6566/1e291f2b170de9f5728e36cc2c6e489477480fa4b215dcf78341531805781448.png)

## كتابة Nim بدون بيئة تشغيل Nim

نظرًا لأن Nim مُشار إليه بشدة من قبل حلول مكافحة الفيروسات، فإن إحدى الطرق لتجاوز ذلك هي كتابة برامج Nim بدون بيئة تشغيل Nim. [كتابة Nim بدون Nim](https://www.youtube.com/watch?v=EXX3HmCG3pw) هي محاضرة تشرح الخطوات حول كيفية كتابة كود Nim بدون بيئة تشغيل Nim و C، الكود المصدري من هذه المحاضرة متاح [هنا](https://github.com/m4ul3r/writing_nimless). تتبع المحاضرة وتوسع في عمل [zimawhit3](https://github.com/zimawhit3) مع [Bitmancer](https://github.com/zimawhit3/Bitmancer/tree/main).

الفكرة هي الاعتماد على تعريفات الأنواع من `winim` والاستفادة من كتابة الكود الذي لا يؤدي إلى استخدام بيئة تشغيل Nim.

## تحويل كود C إلى Nim

https://github.com/nim-lang/c2nim

استخدمته لترجمة مجموعة من مقاطع C الصغيرة، لم أجرب أي شيء كبير.

## جسور لغوية

  - تكامل بايثون https://github.com/yglukhov/nimpy
    * هذا مثير للاهتمام حقًا، [خاصة هذا الجزء](https://github.com/yglukhov/nimpy/blob/master/nimpy/py_lib.nim#L330). مع بعض التعديل، هل يمكن تحميل PythonxXX.dll من الذاكرة؟

  - تكامل Jave VM: https://github.com/yglukhov/jnim

## تصحيح الأخطاء

استخدم دالة `repr()` مع `echo`، تدعم جميع أنواع البيانات تقريبًا (؟؟)، حتى الهياكل!

انظر [منشور المدونة هذا للمزيد](https://nim-lang.org/blog/2017/10/02/documenting-profiling-and-debugging-nim-code.html)

## إعداد بيئة تطوير

يدعم هذا المستودع [حاويات تطوير VSCode] (https://code.visualstudio.com/docs/remote/create-dev-container) والتي تتيح لك التطوير داخل حاوية Docker. هذا يؤتمتة إعداد بيئة تطوير لك.

1. قم بتثبيت VSCode و Docker desktop
2. استنساخ هذا المستودع وفتحه في VSCode
3. قم بتثبيت إضافة `Visual Studio Code Remote - Containers`
4. افتح لوحة الأوامر واختر الأمر `Remote-Containers: Reopen in Container`

سيقوم VScode الآن ببناء صورة Docker (سيستغرق بعض الوقت) ويضعك مباشرة في بيئة تطوير Nim المعدة مسبقًا!

## المزالق التي وجدت نفسي أقع فيها

- عند استدعاء winapi باستخدام Winim ومحاولة تمرير قيمة فارغة، تأكد من تمرير القيمة `NULL` (المعرفة داخل مكتبة Winim) بدلاً من قيمة `nil` المدمجة في Nim. (آه)

- للحصول على مقبض نظام التشغيل للملف الذي تم إنشاؤه بعد استدعاء `open()` على Windows، تحتاج إلى استدعاء `f.getOsFileHandle()` **وليس** `f.getFileHandle()` لأسباب ما.

- يقبل مترجم Nim الوسائط بصيغة `-a=value` أو `--arg=value` على الرغم من أنه إذا نظرت إلى الاستخدام، فإنه يمرر الوسائط فقط كـ `-a:value` أو `--arg:value`. (مهم لملفات Makefiles)

- عند تعريف مصفوفة بايت، تحتاج أيضًا إلى الإشارة على الأقل في القيمة الأولى إلى أنها مصفوفة بايت، غريب بعض الشيء لكن لا بأس (https://forum.nim-lang.org/t/4322)

مصفوفة بايت في C#:```csharp
byte[] buf = new byte[5] {0xfc,0x48,0x81,0xe4,0xf0,0xff}

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

- https://github.com/dom96/jester
- https://github.com/pragmagic/karax
- https://github.com/Niminem/Neel
- https://github.com/status-im/nim-libp2p
- https://github.com/PMunch/libkeepass
- https://github.com/def-/nim-syscall
- https://github.com/tulayang/asyncdocker
- https://github.com/treeform/ws
- https://github.com/guzba/zippy
- https://github.com/rockcavera/nim-iputils
- https://github.com/FedericoCeratto/nim-socks5
- https://github.com/CORDEA/backoff
- https://github.com/treeform/steganography
- https://github.com/miere43/nim-registry
- https://github.com/status-im/nim-daemon

## روابط Nim لتطوير البرامج الضارة

- https://web.archive.org/web/20210117002945/https://secbytes.net/implant-roulette-part-1:-nimplant/
- https://securelist.com/zebrocys-multilanguage-malware-salad/90680/
- https://github.com/MythicAgents/Nimplant
- https://github.com/elddy/Nim-SMBExec
- https://github.com/elddy/NimScan

## المساهمون 

عناق افتراضي لكل من ساهم ❤️

<a href="https://github.com/byt3bl33d3r/OffensiveNim/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=byt3bl33d3r/OffensiveNim" />
</a>