Kripton-Guard

Receive notification via your Android Phone when unknown devices is connected to the network.

Technical Details

Kripton Guard, saves MAC addresses to a SQLite database by sending ARP packets to your network in the learning process, when the learning process is completed, it compares the devices in the network with the devices that already registered in the database. If the device is unknown it sends a notification to your phone.

Kripton Guard uses Google Firebase Authentication for authentication, associates your user id with device id and saves it in Google Realtime Database. It sends you notifications via Google Firebase Cloud Messaging when new device is found.

Installation

Clone the repository:

$ git clone https://github.com/COMU/kripton-guard.git

-- Android

You need to install kripton-guard.apk to your Android Phone. After that, fill in the required information on the form and create an account.

-- Python

Kripton Guard uses scapy, pyrebase, pyfcm, python-crontab libraries and you can easily install them with pip:

$ cd kripton-guard
$ pip install -r requirements.txt

Edit [SETTINGS] section in Python/kripton-guard.conf

    Note: repeattime gets value in minutes

Run Python/install.py with sudo privileges:

$ cd Python
$ sudo python install.py

If Kripton Guard is installed correctly, kripton-guard.conf file will be moved to /etc/kripton-guard and kripton-guard.py file moved to /opt/kripton-guard.

Usage

After a few minutes, your phone will start to get notification whenever a new device join to your network.

Development Plan

1- I will add the APK to the Google Play Store.

2- I am going to make a pip module for Python setup script.

Github Repository

https://github.com/COMU/kripton-guard

---

Posted on Utopian.io - Rewarding Open Source Contributors

---