OWASP SecureTea Project

From OWASP
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.


How can I participate in your project?

All you have to do is make the Project Leader's aware of your available time to contribute to the project. It is also important to let the Leader's know how you would like to contribute and pitch in to help the project meet it's goals and milestones. There are many different ways you can contribute to an OWASP Project, but communication with the leads is key.

If I am not a programmer can I participate in your project?

Yes, you can certainly participate in the project if you are not a programmer or technical. The project needs different skills and expertise and different times during its development. Currently, we are looking for researchers, writers, graphic designers, and a project administrator. See the Road Map and Getting Involved tab for more details.

Contributors

Everyone is invited to collaborate on this project.

The OWASP SecureTea Project is extremely grateful for all of our contributors both prior to becoming open source and after. A live update of project contributors is found here.

Road Map

  • Gather existing presentations and pull ideas into OWASP.
  • Review IoT and identify security issues handled by these application.
  • Review PYTHON related literature (books, articles, ...)
  • Document ways to secure computer/laptop.

Getting Involved

Involvement in the development and promotion of OWASP SecureTea Tool Project is actively encouraged! You do not have to be a security expert or a programmer to contribute. Some of the ways you can help are as follows:

Coding

We could implement some of the later items on the roadmap sooner if someone wanted to help out with unit or automated regression tests

Localization

Are you fluent in another language? Can you help translate the text strings in the OWASP SecureTea Tool Project into that language?

Testing

Do you have a flair for finding bugs in software? We want to product a high quality product, so any help with Quality Assurance would be greatly appreciated. Let us know if you can offer your help.

Feedback

Please Join to Telegram Group OWASP Indonesia for feedback about:

  • What do like?
  • What don't you like?
  • What features would you like to see prioritized on the roadmap?
PROJECT INFO
What does this OWASP project offer you?
RELEASE(S) INFO
What releases are available for this project?
what is this project?
Name: OWASP SecureTea Tool Project
Purpose: 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 (on twitter) whenever her laptop accessible. This small application was developed and tested in python in linux machine likely to be working well in the Raspberry Pi as well.
License: OWASP SecureTea Project is free software, released under the GNU GPL v3 License.
who is working on this project?
Project Leader(s):
how can you learn more?
Project Pamphlet: Not Yet Created
Project Presentation:
Mailing list: N/A
Project Roadmap: Not Yet Created
Key Contacts
  • Contact the GPC to report a problem or concern about this project or to update information.
current release
1.0
last reviewed release
1.0


other releases