mosart_inject
==============

Presentation
------------
**mosart_inject** allows to inject Mosart frames. It works with a `RFStorm Device <devices.html#mosart-rfstorm-device>`_.
It imports the frames stored in a PCAP file (provided as *PCAP_FILE* parameter) and uses the provided interface to inject them.

You have to provide a target using the *TARGET* parameter and you can choose the injection channel thanks to the *CHANNEL* parameter. 

Finally, you can enable the *SYNC* mode if you want to inject your frames synchronously with the Sync packets transmitted by the target dongle.

Compatible devices
------------------

 * `RFStorm Device <devices.html#mosart-rfstorm-device>`_
 * `PCAP Files <devices.html#mosart-pcap-files>`_

Input parameters
-----------------

+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+
| Name                                   | Default value                         | Possible values                                             | Description                                                                               |
+========================================+=======================================+=============================================================+===========================================================================================+
| INTERFACE                              | rfstorm0                              | rfstormX                                                    | Interface to use                                                                          |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+
| TARGET                                 |                                       | <Mosart adress>                                             | Address of the target device                                                              |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+
| CHANNEL                                | 36                                    | <integer>                                                   | Injection channel                                                                         |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+
| PCAP_FILE                              |                                       | <file path>                                                 | PCAP file                                                                                 |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+
| SYNC                                   | yes                                   | yes\|no                                                     | Sync mode enabled                                                                         |
+----------------------------------------+---------------------------------------+-------------------------------------------------------------+-------------------------------------------------------------------------------------------+

Output parameters
------------------

This module doesn't provide any output parameters. 

Usage
------

Basic Usage
^^^^^^^^^^^^

If you want to inject frames to a specific target, you have to provide the *TARGET* parameter and the *CHANNEL* parameter:

::

	$ mirage mosart_inject TARGET=F4:BF:1E:86 CHANNEL=36 PCAP_FILE=/tmp/replay.pcap 
	[INFO] Module mosart_inject loaded !
	[SUCCESS] PCAP file successfully loaded (DLT : 149) ! 
	[INFO] Extracting packet stream from PCAP ...
	[SUCCESS] Packet stream successfully extracted !
	[INFO] Injecting ...
	[SUCCESS] Injection done !
	[INFO] Mirage process terminated !


Performing a replay attack
^^^^^^^^^^^^^^^^^^^^^^^^^^^

This module can be combined with `mosart_sniff <modules.mosart_sniff.html>`_ in order to perform a replay attack:

::

	$ sudo mirage "mosart_sniff|mosart_inject" mosart_sniff1.CHANNEL=20 mosart_sniff1.TARGET=F4:82:F7:16 mosart_sniff1.PCAP_FILE=/tmp/replaymosart.pcap mosart_sniff1.TIME=5
	[INFO] Module mosart_sniff loaded !
	[INFO] Module mosart_inject loaded !
	[SUCCESS] PCAP file successfully loaded (DLT : 149) ! 
	[PACKET] [ CH:20 ] << Mosart - Mouse Movement Packet | address=F4:82:F7:16 | payload=f0f0f482f7164cf9fff9ffb38ea5 | x1=-7 | y1=-1 | x2=-7 | y2=-1 >>
	[PACKET] [ CH:20 ] << Mosart - Mouse Movement Packet | address=F4:82:F7:16 | payload=f0f0f482f71646f802f704d162a5 | x1=-8 | y1=2 | x2=-9 | y2=4 >>
	[PACKET] [ CH:20 ] << Mosart - Mouse Movement Packet | address=F4:82:F7:16 | payload=f0f0f482f7164eff03ff04488fa5 | x1=-1 | y1=3 | x2=-1 | y2=4 >>
	[...]
	[PACKET] [ CH:20 ] << Mosart - Mouse Movement Packet | address=F4:82:F7:16 | payload=f0f0f482f7164e03fb02fd6f0ea5 | x1=3 | y1=-5 | x2=2 | y2=-3 >>
	[PACKET] [ CH:20 ] << Mosart - Mouse Movement Packet | address=F4:82:F7:16 | payload=f0f0f482f7164801fa01fa063ca5 | x1=1 | y1=-6 | x2=1 | y2=-6 >>
	[INFO] Extracting packet stream from PCAP ...
	[SUCCESS] PCAP file successfully loaded (DLT : 149) ! 
	[SUCCESS] Packet stream successfully extracted !
	[INFO] Injecting ...
	[SUCCESS] Injection done !
	[INFO] Mirage process terminated !