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

Difference between revisions of "OWASP SecureTea Project"

From OWASP
Jump to: navigation, search
(Licensing)
Line 8: Line 8:
 
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 [https://twitter.com twitter], whenever anyone accessing his laptop or computer. This application work using the touchpad / mouse / wireless mouse and developed in [https://www.python.org/ python].
 
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 [https://twitter.com twitter], whenever anyone accessing his laptop or computer. This application work using the touchpad / mouse / wireless mouse and developed in [https://www.python.org/ 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 ([https://tealinuxos.org/ TeaLinuxOS]) likely to be working well in the Raspberry Pi as well.
+
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.
  
 
==Description==
 
==Description==
Line 27: Line 27:
 
* Mobile phones are already installed Twitter application (Optional)
 
* Mobile phones are already installed Twitter application (Optional)
 
II. SOFTWARE :
 
II. SOFTWARE :
* Python - <nowiki>https://www.python.org/</nowiki> (<code>sudo apt-get install python</code>)
+
* Python - <nowiki>https://www.python.org/</nowiki> 
 
* Twitter Python Package - <nowiki>https://pypi.python.org/pypi/twitter</nowiki> (already present in the repo: <code>twitter-1.17.1</code>)
 
* Twitter Python Package - <nowiki>https://pypi.python.org/pypi/twitter</nowiki> (already present in the repo: <code>twitter-1.17.1</code>)
 
* The Twitter account - <nowiki>https://twitter.com</nowiki>
 
* The Twitter account - <nowiki>https://twitter.com</nowiki>
 
* Mobile phones are already installed Twitter application (Optional)
 
* Mobile phones are already installed Twitter application (Optional)
  
== Procedure ==
+
= Procedure Installation : =
# Python must be installed. (If not already installed: <code>sudo apt-get install python</code>)
+
# Python and python-setuptools must be installed. (If not already installed: <code>sudo apt-get install python</code>) and then<code>sudo apt-get install python-setuptools</code>
# Install twitter package of this repo:
+
# Download/Clone repository from : https://github.com/idbmb/SecureTea.git  <code>git clone https://github.com/idbmb/SecureTea.git</code>
* <code>cd SecureTea / twitter-1.17.1 /</code>
+
# Install twitter package of this repo: <code>cd SecureTea/twitter-1.17.1</code> <code>sudo python setup.py build install</code>
* <code>sudo python setup.py build install</code>
+
# Visit [https://apps.twitter.com/ https://apps.twitter.com] and "Create new app" to obtain authentication and token codes.
# Visit <nowiki>https://apps.twitter.com</nowiki> and "Create new app" to obtain authentication and token codes.
+
# Open the "SecureTea.py" with a text editor and edit the following variables :
# Open the "SecureTea.py" with a text editor and edit the following variables:
+
 
* API_KEY = 'XXXX'
+
'''Copy/Paste API KEY and TOKEN from Twitter apps'''
* API_SECRET = 'XXXX'
+
 
* ACCESS_TOKEN = 'XXXX'
+
API_KEY = 'XXXX'
* ACCESS_TOKEN_SECRET = 'XXXX'
+
 
* TWITTER_USERNAME = 'XXXX'
+
API_SECRET = 'XXXX'
# Optionally in "SecureTea.py" You can set debug = <code>1</code> to enable the console log (default: enabled). or <code>set debug = 0</code>without logging in console.
+
 
# Install Mouse / Wireless Mouse Touchpad if not functioning properly (Linux / Raspberry machine).
+
ACCESS_TOKEN = 'XXXX'
# Okay, Run program -> <code>sudo python SecureTea.py</code>
+
 
# Notice his WELCOME_MSG Like this: <code>Welcome to SecureTea .. !! Initializing System @ Mon Mar 20 17:06:28 2017</code>
+
ACCESS_TOKEN_SECRET = 'XXXX'
# 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. <code>Alert (1): Someone has access your laptop when Mon Mar 20 17:04:13 2017</code>
+
TWITTER_USERNAME = 'XXXX'
 +
 
 +
* Optionally in "SecureTea.py" You can set debug = <code>1</code> to enable the console log (default: enabled). or <code>set debug = 0</code>without logging in console.
 +
* Install Mouse / Wireless Mouse Touchpad if not functioning properly (Linux / Raspberry machine).
 +
* Okay, Run program -> <code>sudo python SecureTea.py</code>
 +
* Notice his WELCOME_MSG Like this: <code>Welcome to SecureTea .. !! Initializing System @ Mon Mar 20 17:06:28 2017</code>
 +
* 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. <code>Alert (1): Someone has access your laptop when Mon Mar 20 17:04:13 2017</code>
  
 
==Licensing==
 
==Licensing==
Line 62: Line 69:
  
 
[https://github.com/idbmb/SecureTea Source Code]
 
[https://github.com/idbmb/SecureTea Source Code]
 
What's New (Revision History)
 
 
Documentation
 
  
 
[https://github.com/idbmb/SecureTea/wiki Wiki Home Page]
 
[https://github.com/idbmb/SecureTea/wiki Wiki Home Page]
Line 71: Line 74:
 
[https://github.com/idbmb/SecureTea/issues Issue Tracker]
 
[https://github.com/idbmb/SecureTea/issues Issue Tracker]
  
Slide Presentation
+
[https://www.youtube.com/watch?v=Fsx3H5g_tPQ&list=PLIl-z1e_zbEZFO-nTsOb2A2MnN2icCt_w Video
 
 
Video (Coming Soon)
 
  
 
== Project Leader ==
 
== Project Leader ==
Line 79: Line 80:
  
 
[[User:Idbmb|Bambang Rahmadi Kurniawan Payu]]
 
[[User:Idbmb|Bambang Rahmadi Kurniawan Payu]]
 +
 +
[[Ade Yoseman Putra]]
  
 
[https://www.owasp.org/index.php/Jakarta OWASP Jakarta Chapter]
 
[https://www.owasp.org/index.php/Jakarta OWASP Jakarta Chapter]

Revision as of 07:46, 4 February 2018

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 (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.

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)
  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/idbmb/SecureTea.git git clone https://github.com/idbmb/SecureTea.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.py" 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.py" 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 / Raspberry machine).
  • Okay, Run program -> sudo python SecureTea.py
  • Notice his WELCOME_MSG Like this: Welcome to SecureTea .. !! Initializing System @ Mon Mar 20 17:06:28 2017
  • 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. Alert (1): Someone has access your laptop when Mon Mar 20 17:04:13 2017

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

Video

Project Leader

Project leader's name

Bambang Rahmadi Kurniawan Payu

Ade Yoseman Putra

OWASP Jakarta Chapter

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

Presentation donwload here (PDF)
Present at Blackhat Asia Sinagpore , March 22 th 2018

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

The OWASP Tool Project Template is developed by a worldwide team of volunteers. A live update of project contributors is found here.

- 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 Tool Project Template 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 Tool Project Template 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 use the Tool Project Template project mailing list for feedback about:

  • What do like?
  • What don't you like?
  • What features would you like to see prioritized on the roadmap?

The Tool Project Template must specify the minimum set of tabs a project should have, provide some an example layout on each tab, provide instructional text on how a project leader should modify the tab, and give some example text that illustrates how to create an actual project.

It would also be ideal if the sample text was translated into different languages.

PROJECT INFO
What does this OWASP project offer you?
RELEASE(S) INFO
What releases are available for this project?
what is this project?
Name: N/A
Purpose: N/A
License: N/A
who is working on this project?
Project Leader(s): N/A
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 contribute to this project
  • Contact the GPC to review or sponsor this project
current release
pending
last reviewed release
pending


other releases