Skip to content

Commit

Permalink
add device rule doc
Browse files Browse the repository at this point in the history
  • Loading branch information
ntestoc3 committed Jan 26, 2022
1 parent dc5e105 commit 84f3023
Show file tree
Hide file tree
Showing 4 changed files with 83 additions and 1 deletion.
1 change: 1 addition & 0 deletions README-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -335,6 +335,7 @@ fapro run -v -l :8080
## 学习更多
- [如何打造一个网络扫描分析平台 - Part I](./howto/howto_CN_1.md)
- [如何打造一个网络扫描分析平台 - Part II](./howto/howto_CN_2.md)
- [如何使用FaPro批量模拟设备](./howto/rule.md)
- [Discord](https://discord.gg/Eaz9dzV4AP)

## 常见问题
Expand Down
1 change: 1 addition & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -339,6 +339,7 @@ Use the **ipclone.py** script in [Scripts](scripts/README.md), You can clone the
## Learn more
- [How to build a network scanning analysis platform - Part I](./howto/howto_1.md)
- [How to build a network scanning analysis platform - Part II](./howto/howto_2.md)
- [How to use FaPro to simulate multiple devices in network](./howto/rule_en.md)
- [Discord](https://discord.gg/Eaz9dzV4AP)

## FAQ
Expand Down
2 changes: 1 addition & 1 deletion howto/rule.md
Original file line number Diff line number Diff line change
Expand Up @@ -76,7 +76,7 @@ sudo ./fapro run -f camera.pak -v
```
会创建一个8.0.0.0/8的虚拟网络,并随机生成设备ip。

![rules demo](../docs/rule.gif)
![camera rules demo](../docs/camera.gif)

使用web界面可以查看ip端口对应的设备规则。

80 changes: 80 additions & 0 deletions howto/rule_en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,80 @@
<h1 align="center">
How to use FaPro to simulate multiple devices in network
</h1>
<br/>

## Introduction

Network and service simulation can already be done using FaPro. However, in a real environment, there are often multiple different devices in a network, and each device runs different services. To simulate a real network environment, it is necessary to simulate these devices.

To simulate a device in a network, we need to simulate all open services on that device. We defined device rules, a rule is a set of service information on all open ports of a device.

With FaPro, you can create a virtual network and simulate several different devices in it with a single command.

We've created a set of device rules for surveillance video equipment from over 30 manufacturers:
```
ABUS IP Camera
ADT NVR
ADT DVR
AJA-Video-Converter
Advidia IP Camera
AirSpace DVR2
AirSpace DVR
Alibi IP Camera
CP Plus DVR2
CP Plus DVR
Canon VB-H610
Clare Control IP Camera
Dahua IP Camera2
Dahua DHI-XVR4104C-N
Dahua IP Camera
Eyesonic IP Camera
GRUNDIG IP Camera
GeoVision-Camera
HIKVISION-Camera2
HIKVISION-Camera
HUAWEI IVS
IC Realtime NVR6000K
IC Realtime NVR7000K
Illustra-camera2
Illustra-camera
InVid Tech IP Camera2
InVid Tech IP Camera
JXJ-Camera2
JXJ-Camera
KB Vision DVR
KT&C IP Camera
KT&C IP Camera2
LG-Smart-IP-Device
Lorex DVR2
Lorex DVR
Lorex DVR3
Luma IP Camera
Luma 310 IP Camera
PARTIZAN-Cameras
Q-See NVR2
Q-See NVR
TRENDnet NVR408
TRENDnet TV-IP862IC
TRENDnet NVR2208
The Surveillance Shop IP Camera
The Surveillance Shop IP Camera2
TruVision TVR Camera
TruVision NVR Camera
WebWarrior IP Camera
WebWarrior IP Camera2
WebWarrior IP Camera3
```

## Usage
Download [Camera Device Rules Pack](https://github.com/fofapro/fapro/raw/master/rules/camera.pak)

Then run fapro with root user to create the simulated device from the rules pack:
```shell
sudo ./fapro run -f camera.pak -v
```
A virtual network of 8.0.0.0/8 will be generated, and the device IP will be randomly generated.

![camera rules demo](../docs/camera.gif)

Use the web interface to view the device rule(App) corresponding to the ip port.

0 comments on commit 84f3023

Please sign in to comment.