ANTICHAT - Учим BadUSB работать с разными раскладками клавиатуры

Заглавие

Всем доброго времени суток, о BadUsb, Usb Rubber Ducky и о том, как самому сделать аналог данного устройства написано уже много статей.
В этой же статье мы рассмотрим решение проблемы BadUsb при работе с разными раскладками клавиатуры. В качестве инструкции по созданию своего BadUsb будем использовать статью размещенную здесь, на античат :

Делаем USB ducky и Wifi Ducky своими руками

В качествеBadUsb, как и в статье используем Arduino Micro Pro.

О чем речь

Если при выполнении скрипта загруженного на наш BadUsb в операционной системе выставлена русская раскладка, возникает проблема, все команды вводятся в русской раскладке и наш скрипт становится бесполезным.

https://forum.antichat.xyz/attachmen...9c7cfecf41.png

Ищем решение этой проблемы

Недолгий поиск в гугле, наводит нас на одно решение, использоватьAlt-коды. Alt-коды в Windows иногда используется для ввода символов, которые отсутствуют на клавиатуре.

Например, зажимаем ALT и удерживая набираем цифры на цифровом блоке Numpad 1 и 3, затем отпускаем ALT и получается вот такой символ ноты ♪ и т.д.
Вот неполная таблица Alt-кодов, полную таблицу можно посмотреть по ссылке: Полная таблица Alt-кодов

https://forum.antichat.xyz/attachmen...65d810fc6c.png

Точно также с помощью alt-кодов мы можем эмулировать нажатия клавиш английского, русского алфавита и всех необходимых символов независимо от текущей раскладки клавиатуры, осталось только модифицировать скетч под наши нужны. Дорабатывать скетч мы будем как для голой ардуинки, так и для Wifi Ducky.

Но сначала немного теории, поговорим о том как наша ардуинка эмулирует нажатия клавиш. В большинстве случаев делает она это с помощью базовой библиотеки Keyboard.h, которая по умолчанию уже встроена в Arduino IDE и подключается в самом начале скетча:

Код:

Код:

1| #include

Изучив документацию к библиотеке Keyboard.h выясняем, что она использует ASCII коды для "печатаемых" символов клавиатуры.

https://forum.antichat.xyz/attachmen...05528da6d1.png

Нам же нужно найти какие коды соответствуют клавишам цифрового блока., чтобы эмулировать нажатия с помощью Alt-кодов.

Итак, первые 128 значений (от 0 до 127) как мы выяснили, "печатаемые", обрабатываются как ASCII код и переводятся в коды клавиш. Следующие 8 (от 128 до 135) - это клавиши модификаторы (Ctrl, Shift, Alt и и т.д.).

Полный список клавиш модификаторов можно посмотреть в документации к библиотеке Keyboard.h Keyboard Modifiers - Arduino Reference.
Далее из всего что превышает 135 (но не больше 256, поскольку один байт может содержать значения до 256) вычитается 136 и используется как код ключа для клавиатуры согласно USB HID спецификациям.

Здесь по ссылке вы можете найти списки кодов USB HID для различных устройств ввода-вывода USB HID Usage Tables (pdf документ). Список кодов конкретно для клавиатуры, начиная со стр. 53 и находим в таблице клавиши цифрового блока и их Usege ID (Dec) в десятичной системе счисления.

https://forum.antichat.xyz/attachmen...7b672b72dc.png

Это и есть то что нам нужно, и как мы помним все значения ниже 128 обрабатываются как ASCII коды, поэтому не забываем прибавлять 136 к Usage ID (Dec).
Получившиеся значения от 225 до 234 и 219 (для NumLock) мы и будем использовать для написания скетча для ардуино.

В библиотеке Keyboard.h есть несколько основных функций которые эмулируют нажатия клавиш:

Код:

Код:

Keyboard.press(parameter)  #- нажатие и удержание клавиши

Keyboard.release(parameter)  #- завершает нажатие клавиши (отпускает клавишу)

Keyboard.write(parameter)  #- нажатие и сразу отпускание клавиши

Keyboard.releaseAll()  #- отпускает все нажатые Keyboard.press() клавиши.

В качестве параметра (parameter, кроме Keyboard.releaseAll() - у нее нет параметров) функции принимают коды клавиш о которых мы говорили выше (ASCII, Клавиши модификаторы и (USB HID Usage ID + 136)), от 0 до 256.

В итоге код который будет эмулировать нажатие клавиш клавиатуры с помощью Alt-кодов будет выглядеть следующим образом
Например для английской буквы n или ALT + 110 (смотрим таблицу Alt-кодов):

Код:

Код:

Keyboard.press(KEY_LEFT_ALT);  // зажимаем ALT

Keyboard.write(225);           // N1

Keyboard.write(225);           // N1

Keyboard.write(234);           // N0

Keyboard.releaseAll();         // отпускаем ALT

Да, многовато кода, 5 строк чтобы написать всего одну букву!
Получится довольно длинный скетч, но он повторяющийся и его можно немного оптимизировать. Такой код уже напечатает полное слово "notepad".

Код:

Код:

void altRun2(int a,int b)

{

  Keyboard.press(KEY_LEFT_ALT);

  Keyboard.write(a);

  Keyboard.write(b);

  Keyboard.releaseAll();

}



void altRun3(int a,int b, int c)

{

  Keyboard.press(KEY_LEFT_ALT);

  Keyboard.write(a);

  Keyboard.write(b);

  Keyboard.write(c);

  Keyboard.releaseAll();

}

void setup()

{

  Keyboard.begin();

  altRun3(225,225,234);

  altRun3(225,225,225);

  altRun3(225,225,230);

  altRun3(225,234,225);

  altRun3(225,225,226);

  altRun2(233,231);

  altRun3(225,234,234);

}

Конечно мы не будем все это писать вручную, в интернете можно найти много реализаций DuckyScript to Arduino code конвертера с открытым исходным кодом, я модифицировал одну из версий такого конвертера и добавил поддержку Alt-кодов.За основу взял ducky2arduino_stable от roothaxor.

Просто используйте стандартный синтаксисDuckyScript, а когда вам нужно сгенерировать скетч который будет эмулировать нажатия клавиш используяAlt-коды, поставьте галочкуActivate Alt-codes supportи замените STRING на ALTCODE

Модифицированный DuckyScript to Arduino Сode конвертер

https://forum.antichat.xyz/attachmen...96a67071b4.png

Эти тестовые примеры запускают notepad и печатают Hello World!!!

С использованием STRING:

Код:

Код:

DELAY 3000

GUI r

DELAY 500

STRING notepad

DELAY 500

ENTER

DELAY 750

STRING Hello World!!!

ENTER

С использованиемALTCODE:

Код:

Код:

DELAY 3000

GUI r

DELAY 500

ALTCODE notepad

DELAY 500

ENTER

DELAY 750

ALTCODE Hello World!!!

ENTER

На выходе получаем вот такой скетч который эмулирует нажатия клавиш с помощью Alt-кодов, запускает notepad и пишет в нем Hello World!!!
И теперь он не зависит от раскладки клавиатуры, то чего мы и хотели!
Обратите внимание на вот эти строки.
Здесь мы повторно запускаем код после нажатия NumlocktypeKey(219) , на случай если цифровой блок был выключен:

Код:

Код:

void setup()

{

  run();

  typeKey(219);

  run();

}

Если вам не нужен повторный запуск просто оставьте один вызов функции run()

Код:

Код:

void setup()

{

  run();

}

Теперь займемся модификацией прошивки для WiFi Ducky.Для начала изучим прошивку для ардуино из статьи Делаем USB ducky и Wifi Ducky своими руками
Обратим внимание на блок команд отвечающих за обработку клавиш модификаторов в функции void Press()
Все что нам остается это дописать свой код, добавляющий обработку клавиш цифрового блока:

Код:

Код:

else if (b.equals("NUMLOCK"))Keyboard.press(219);

else if (b.equals("N9")) {Keyboard.press(233); Keyboard.release(233);}

else if (b.equals("N8")) {Keyboard.press(232); Keyboard.release(232);}

else if (b.equals("N7")) {Keyboard.press(231); Keyboard.release(231);}

else if (b.equals("N6")) {Keyboard.press(230); Keyboard.release(230);}

else if (b.equals("N5")) {Keyboard.press(229); Keyboard.release(229);}

else if (b.equals("N4")) {Keyboard.press(228); Keyboard.release(228);}

else if (b.equals("N3")) {Keyboard.press(227); Keyboard.release(227);}

else if (b.equals("N2")) {Keyboard.press(226); Keyboard.release(226);}

else if (b.equals("N1")) {Keyboard.press(225); Keyboard.release(225);}

else if (b.equals("N0")) {Keyboard.press(234); Keyboard.release(234);}

В итоге получаем такую прошивку:
Ей мы и будем прошивать ардуинку для WiFi Ducky.

СинтаксисDuckyScript для такой версии WiFi Ducky также будет немного отличаться, вместо STRINGнам нужно вводить символы как если бы мы нажимали последовательность Alt-кодов (см. таблицу Alt-кодов).

Например слово notepadтеперь будет выглядеть так:

Код:

Код:

ALT N1 N1 N0

ALT N1 N1 N1

ALT N1 N1 N6

ALT N1 N0 N1

ALT N1 N1 N2

ALT N9 N7

ALT N1 N0 N0

И чтобы облегчить задачу, я написал простенький конвертер.
Конвертер Alt-кодов

Вам всего лишь нужно подставить стоку которая шла после STRING в конвертер и на выходе получить последовательность Alt-кодов. Эту последовательность мы используем для написания полезной нагрузки для нашей модифицированной WiFi Ducky.
Не забываем про NUMLOCK, на случай если клавиши цифрового блока отключены.

Тестовый скрипт который открывает notepad и пишет в нем Hello World!!! будем выглядеть следующим образом:

Краткие выводы

Что мы в итоге получили? Не самый производительный вариант, в плане того что такие скрипты будут дольше выполнятся, оно и понятно, мы эмулируем нажатие трех - четырех клавиш вместо одной. Приходиться использовать дублирование кода на случай если клавиши цифрового блока отключены NumLock'ом. В сценариях использования BadUsb когда у нас есть физический доступ к компьютеру, иногда проще поменять раскладку.

Если у вас есть предложения по улучшению или вы знаете еще способы обойти проблему раскладок для BadUsd, делитесь идеями в обсуждении.