This site is the archived OWASP Foundation Wiki and is no longer accepting Account Requests.
To view the new OWASP Foundation website, please visit https://owasp.org

OWASP SecureTea Project

From OWASP
Revision as of 06:50, 31 August 2018 by Yoseman (talk | contribs)

Jump to: navigation, search
OWASP Project Header.jpg

OWASP SecureTea Tool Project

The OWASP SecureTea Project is a application designed to help Secure a person's laptop or computer with IoT (Internet Of Things) for notify users via twitter, whenever anyone accessing his laptop or computer. This application work using the touchpad / mouse / wireless mouse and developed in python.

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.

Description

The OWASP SecureTea Project that was developed to be used by anyone who is interested in Security IOT (Internet of Things) and still needs further development.

How it functions:

  • Keep track of the movement of the mouse / touchpad
  • Detect who access the laptop with mouse / touchpad is installed
  • Send warning messages on Twitter

Objective

To alert the user via twitter, whenever her laptop had been accessed someone.

Pre-requisites

I. HARDWARE :

  • Linux OS / Raspberry Pi - have sudo access on the terminal / console
  • Mouse / Wireless Mouse / Touchpad congenital laptop
  • Mobile phones are already installed Twitter application (Optional)

II. SOFTWARE :

  • Python - https://www.python.org/ 
  • Twitter Python Package - https://pypi.python.org/pypi/twitter (already present in the repo: twitter-1.17.1)
  • The Twitter account - https://twitter.com
  • Mobile phones are already installed Twitter application (Optional)

Procedure Installation

  1. Python and python-setuptools must be installed. (If not already installed: sudo apt-get install python) and thensudo apt-get install python-setuptools
  2. Download/Clone repository from : https://github.com/OWASP/SecureTea-Project.git git clone https://github.com/OWASP/SecureTea-Project.git
  3. Install twitter package of this repo: cd SecureTea/twitter-1.17.1 sudo python setup.py build install
  4. Visit https://apps.twitter.com and "Create new app" to obtain authentication and token codes.
  5. 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 = 'XXXX'

ACCESS_TOKEN = 'XXXX'

ACCESS_TOKEN_SECRET = 'XXXX'

TWITTER_USERNAME = 'XXXX'

  • Optionally in "securetea.json" You can set debug = 1 to enable the console log (default: enabled). or set debug = 0without logging in console.
  • Install Mouse / Wireless Mouse Touchpad if not functioning properly (Linux / macOS / Raspberry Pi machine).
  • Okay, Run program -> sudo SecureTea.py
  • Notice his WELCOME_MSG Like 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


Missing Dependency :

twitter package is a dependency, it will be installed automatically installed while installing SecureTea. If not installed Please install it as follows

Install twitter package from repo: cd SecureTea/twitter-1.17.1 sudo python setup.py build install

Tested on:

TealinuxOS - Worked
Deepin - Worked
Raspbian - Worked
macOS - Worked
Ubuntu - Worked

Licensing

GNU GPL v3 License

This program is free software: you can redistribute it and/or modify it under the terms of the link GNU Affero General Public License 3.0 as published by the Free Software Foundation, either version 3 of the License.

Project Resources

Installation Package

Source Code

Wiki Home Page

Issue Tracker

Presentation (PDF)

Video Demo

Project Leader

Join Telegram Group :

OWASP Jakarta Chapter (ID)

Open Hub

https://www.openhub.net/p/734848

Related Projects

Classifications

Project Type Files TOOL.jpg
Incubator Project Owasp-builders-small.png
Owasp-defenders-small.png
Affero General Public License 3.0

News and Events

  • [20 Mar 2017] 1.0 Beta Release candidate is available for download. First release for trial period.
  • [04 Feb 2018] 1.0 Release Candidate is available for download. This release provides final bug fixes and product stabilization. Any feedback (good or bad) in the next few weeks would be greatly appreciated.
  • [25 Jan 2018] Published in ToolsWatch.org, Blackhat Arsenal Asia 2018 Great Lineup.