Small IoT (Internet of Things) to notify users via Twitter, whenever someone accesses their laptop. This application uses the touchpad/mouse/wireless mouse to determine activity and is developed in Python and tested on Linux.
The purpose of this application is to warn the user (via various communication mechanisms) whenever their laptop accessed. This small application was developed and tested in python in Linux machine is likely to work well on the Raspberry Pi as well.
- Target User
- Objective
- Pre-requisites
- Procedure Installation
- Getting Twitter Tokens
- Getting Twilio Tokens
- Getting Slack Tokens
- Tested on
- Suggestions and contributing
- Code Of Conduct
- Chat Group
- Roadmap
It was written to be used by anyone who is interested in Security IoT (Internet of Things) and still needs further development.
- Keep track of the movement of the mouse/touchpad
- Detect who access the laptop with mouse/touchpad is installed
- Send warning messages on Twitter/SMS/Slack/Telegram
To alert the user via variuos communication mechanism, whenever his/her laptop had been accessed by someone. And also it can be used to monitor your system.
- Linux OS / Raspberry Pi - have
sudoaccess on the terminal/console - Mouse / Wireless Mouse / Touchpad congenital laptop
- The Twitter application is already installed on the mobile phone (Optional)
- Python - https://www.python.org/ (
sudo apt-get install python) - Angular - https://angular.io/
- A Twitter account - https://twitter.com
- A Twilio account(optional, if SMS service not required)
- Mobile phone, a previously-installed Twitter application (Optional)
-
Python and python-setuptools must be installed. (If not already installed:
sudo apt-get install python python-setuptools) -
Download/Clone repository from: https://github.com/OWASP/SecureTea-Project.git
git clone https://github.com/OWASP/SecureTea-Project.git
- Install SecureTea package:
cd SecureTea-Projectpython setup.py install
- Install python dependencies/ requirements
pip install -r requirements.txt
- Open the "securetea.conf" in your home directory (~/.securetea/securetea.conf) with a text editor and edit the following variables :
Copy/Paste API KEY and TOKEN from Twitter apps
"api_key": "XXXX",
"api_secret_key": "XXXX",
"access_token": "XXXX",
"access_token_secret": "XXXX",
"username": "XXXX"
-
Optionally in "securetea.conf" You can set
"debug" : trueto enable the console log (default: enabled), or set"debug" : falseto disable logging to console. -
Install Mouse / Wireless Mouse Touchpad if not functioning properly (Linux / macOS / Raspberry Pi machine).
-
Okay, Run program ->
sudo SecureTea.pyor more ->SecureTea.py -h -
Notice a
WELCOME_MSGLike this:[Core] [ 2018-08-30 16:50 ] Info : Welcome to SecureTea..!! Initializing System -
Laptop access by moving the mouse/touchpad to see the cumulative X and Y coordinates on the console. If you have a twitter app installed on your phone, you can get updates on the "message" from your twitter account.
-
Checks Alert message on the console and on twitter your inbox.
[Core] [ 2018-08-30 16:50 ] Warn : (3) : Someone has access your laptop when -
If you want to monitor your system from a webapp,
cd guinpm installng serve
- Click new tab terminal and type ->
sudo python monitor.py - Go to
http://localhost:4200to view your project. END-POINT typehttp://localhost:5000and click SIGN IN.
- Visit https://apps.twitter.com and "Create new app" to obtain authentication and token codes.
- Visit https://www.twilio.com and click on "Get a free API key".
- Visit https://api.slack.com/apps/new and create a new bot app.
- In the bot app settings, setup event subscriptions by Enabling Events.
- Install the bot app in the workspace required.
- Get the "Bot User OAuth Access Token", it starts with
xoxb- - Get your user id for the particular workspace.
- TealinuxOS - Worked
- Deepin - Worked
- Raspbian - Worked
- macOS - Worked
- Ubuntu - Worked
- For contributors, please add your name below:
- Ade Yoseman
- Bambang Kurniawan
- Felex kemboi
- Lojislav Bezimenov
- Rejah Rehim
- Ananthu S
- Notify by Twitter
- Securetea Dashboard / GUI
- Securetea Protection /firewall
- Securetea Antivirus
- Intelligent Log Monitoring
- Login History
- Notify by Whatsapp
- Notify by SMS Alerts
- Notify by Line
- Notify by Telegram
- Notify by Slack
| SecureTea Tool Features | Progress |
|---|---|
| Notify by Twitter | Yes |
| Securetea Dashboard | Yes |
| Notify by Telegram | Yes |
| Notify by Slack | Yes |
| Notify by SMS Alerts | Yes |