Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/h3pr5tq/get-rssi
Linux utility for getting RSSI WiFi of APs to text file. Using Monitor mode, libpcap. Useful for experiments with WiFi (example, localization).
https://github.com/h3pr5tq/get-rssi
Last synced: 25 days ago
JSON representation
Linux utility for getting RSSI WiFi of APs to text file. Using Monitor mode, libpcap. Useful for experiments with WiFi (example, localization).
- Host: GitHub
- URL: https://github.com/h3pr5tq/get-rssi
- Owner: h3pr5tq
- Created: 2016-10-17T11:07:55.000Z (about 8 years ago)
- Default Branch: master
- Last Pushed: 2016-11-19T15:25:56.000Z (about 8 years ago)
- Last Synced: 2024-08-03T17:11:28.454Z (4 months ago)
- Language: C
- Homepage:
- Size: 20.5 KB
- Stars: 6
- Watchers: 1
- Forks: 7
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-network-stuff - **0**星
README
# get-rssi
Данная Linux-утилита позволяет получить информацию об изменении уровня WiFi сигнала (RSSI) окружающих точек доступа (Access Point, AP) в течении заданного интервала времени. Утилита выполняет следующее:
1. захват beacon фреймов указанных AP;
2. сохранение захваченных beacons в cap-файл;
3. разбор cap-файла с целью извлечения значений RSSI сигналов WiFi, принимаемых Linux-устройством (на котором запущена утилита) в моменты времени, которые соответствуют приёму каждого beacon фрейма;
4. сохранение значений RSSI в отдельный текстовый файл (txt-файл).
Пользователь задаёт:
* время, в течение которого будет происходить захват beacon фреймов;
* MAC-адреса точек доступа, фреймы только которых будут захватываться.
Ограничения (подробнее см. **Примечание**):
* сетевой интерфейс должен находится в *Monitor* режиме *ПЕРЕД* запуском утилиты;
* все заданные AP должны работать на *одном и том же* частотном канале;
* частотный канал сетевого интерфейса должен *совпадать* с частотным каналом заданных AP.
## Установка
Ниже приведён пример установки для Debian Stretch.
1) Установить пакеты, необходимые для сборки и работы утилиты: *build-essential, libpcap0.8, libpcap-dev*. Это можно сделать, например, так:
```
sudo apt-get update
sudo apt-get install build-essential libpcap0.8 libpcap-dev
```
2) Скачать файлы данного репозитория. Можно скачать архивом с помощью браузера (кнопка *Clone or download*); или, если установлен *git*, выполнив команду:
```
git clone https://github.com/h3pr5tq/get-rssi.git
```
3) Для сборки надо перейти в папку проекта *.../get-rssi/* (предварительно разархивировав, если скачивали с помощью браузера) и выполнить команды:
```
make
sudo make install
```
Готово!
Для удаления утилиты выполните `sudo make uninstall` или тоже самое, но напрямую `sudo rm /usr/local/bin/get-rssi`.
В случае ошибок при сборке необходимо очистить промежуточные файлы. Это можно сделать с помощью команды `make clean`.
## Использование
Пример в случае одной точки доступа:
```
sudo get-rssi -i mon0 -f ~/rssi -b 01:FA:23:18:12:F2 -t 100
```
Пример в случае нескольких точек доступа:
```
sudo get-rssi -i mon0 -f ~/rssi -b 01:FA:23:18:12:F2,02:bc:19:72:af:ff,01:CC:31:87:af:ff -t 100
```
Утилита требует 4 обязательных аргумента:
* `-i` - имя сетевого интерфейса в Monitor режиме;
* `-f` - префикс для cap- и txt-файла; например, в случае `-f ~/rssi` утилита создаст *~/rssi.cap* и *~/rssi.txt* файлы;
* `-b` - MAC-адреса точек доступа, beacons только которых будут захватываться; в случае нескольких точек доступа MAC-адреса перечисляем через запятую, *БЕЗ* пробелов;
* `-t` - время в секундах, в течении которого будет происходить захват beacons; данное значение примерно соответствует времени выполнения утилиты.
По окончанию выполнения утилиты должны получить два файла: cap и txt. Текстовый файл будет иметь следующий вид:
(В случае одной AP)
```
timestamp (sec): RSSI (dBm): BSSID:
0.000000 -79 01:FA:23:18:12:F2
0.102371 -78 01:FA:23:18:12:F2
0.204696 -77 01:FA:23:18:12:F2
0.307270 -78 01:FA:23:18:12:F2
0.409626 -78 01:FA:23:18:12:F2
0.512004 -77 01:FA:23:18:12:F2
0.716764 -78 01:FA:23:18:12:F2
1.024013 -77 01:FA:23:18:12:F2
1.126392 -77 01:FA:23:18:12:F2
1.228766 -81 01:FA:23:18:12:F2
1.331143 -81 01:FA:23:18:12:F2
1.433533 -80 01:FA:23:18:12:F2
1.536041 -84 01:FA:23:18:12:F2
1.638399 -82 01:FA:23:18:12:F2
1.740775 -85 01:FA:23:18:12:F2
2.252738 -84 01:FA:23:18:12:F2
________________________________________________
Number of all sniff beacon frames: 16 (it coincides with number of RSSI values)
BSSID 01:FA:23:18:12:F2 : 16 of 16
```
(В случае двух AP)
```
timestamp (sec): RSSI (dBm): BSSID:
0.000000 -85 02:BC:19:72:AF:FF
0.068741 -77 01:FA:23:18:12:F2
0.205759 -84 02:BC:19:72:AF:FF
0.376063 -78 01:FA:23:18:12:F2
0.478443 -76 01:FA:23:18:12:F2
0.512194 -86 02:BC:19:72:AF:FF
0.580815 -76 01:FA:23:18:12:F2
0.683213 -76 01:FA:23:18:12:F2
0.716832 -86 02:BC:19:72:AF:FF
0.819212 -85 02:BC:19:72:AF:FF
0.888077 -76 01:FA:23:18:12:F2
0.921616 -87 02:BC:19:72:AF:FF
0.990374 -77 01:FA:23:18:12:F2
1.023950 -87 02:BC:19:72:AF:FF
1.126447 -88 02:BC:19:72:AF:FF
1.197198 -79 01:FA:23:18:12:F2
1.297653 -77 01:FA:23:18:12:F2
1.400074 -76 01:FA:23:18:12:F2
1.535951 -86 02:BC:19:72:AF:FF
1.604828 -75 01:FA:23:18:12:F2
1.638330 -87 02:BC:19:72:AF:FF
1.707208 -75 01:FA:23:18:12:F2
1.740835 -86 02:BC:19:72:AF:FF
1.809829 -75 01:FA:23:18:12:F2
1.843779 -86 02:BC:19:72:AF:FF
1.912085 -76 01:FA:23:18:12:F2
2.014458 -76 01:FA:23:18:12:F2
________________________________________________
Number of all sniff beacon frames: 27 (it coincides with number of RSSI values)
BSSID 01:FA:23:18:12:F2 : 15 of 27
BSSID 02:BC:19:72:AF:FF : 12 of 27
```
## Примечание
#### 1) Настройка сетевого интерфейса для работы с утилитой
Настройка предполгает последовательное выполнение следующих действий:
1. Завершение выполняющихся сетевых процессов, отвечающих за WiFi-соединение (обычно это wpa_supplicant, dhclient, NetworkManager и т.п.). Это необходимо для корректной работы *Monitor* режима.
* `sudo airmon-ng check kill` - автоматическое завершение сетевых процессов (необходимо установить пакет *aircrack-ng*);
* `sudo kill PID` или `sudo systemctl stop SERVICE_NAME` - завершение сетевых процессов в ручную, используя стандартные системные утилиты.
2. Включение выбранного сетевого интерфейса (который будем переводить в *Monitor* режим) и отключение лишних (остальных) *беспроводных* сетевых интерфейсов.
* `sudo iw dev` - просмотр доступных беспроводных сетевых интерфейсов;
* `sudo ip link set up` - включение интерфейса;
* `sudo ip link set down` - отключение интерфейса.
3. Перевод выбранного сетевого интерфейса в *Monitor* режим.
* `sudo airmon-ng start ` - используя пакет *aircrack-ng*;
или
* `sudo iw dev set monitor none` - используя стандартную системную утилиту.
4. Конфигурирование выбранного сетевого интерфейса на определённый частотный канал.
* `sudo iw dev set channel CHANNEL`, где *CHANNEL* - номер частотного канала: 1 - 13;
или
* `sudo iw dev set freq FREQ` - тоже самое, но указываем центральную частоту FREQ.
#### 2) Другое
* Заданные APs (аргумент `-b`) должны рабоать на одном и том же частотном канале, который совпадает с частотным каналом сетевого интерфейса Linux-устройства (где запущена утилита). Также необходимо знать MAC-адреса APs. Получить данную информацию удобно с помощью утилиты *airodump-ng* (входит в состав пакета *aircrack-ng*).
* Кол-во захваченных beacons от каждой AP за заданное время зависит от RSSI (для конкретной AP) и beacon interval (параметр AP, показывающий как часто AP будет отправлять beacon фреймы).