mindcrypt / assap

Anti Shoulder Surfing Attack Platform (ASSAP)

Anti Shoulder Surfing Attack Platform (ASSAP)

ASSAP is a multiplatform tool whose aim is to stablish deffensive measures against shoulder surfing attack, technique used for getting confidential information.

The application has different security measures that can be configured by the users depending on the moment of use. ASSAP is designed to be simple to use so that anyone without knowledge can activate and use it, preventing other people from obtaining their confidential data such as passwords, bank accounts, private data, etc.

Features

The size of the application window is small in order not to disturb user work. Furthermore, it is draggable to place it where least bothers in each moment.

The user will have ASSAP window over the other ones to know what is happening behind him.

The application can be stopped if the user does not need the security feature.

Demo

Actions

When the Shoulder Sourfing Attack is detected, the tool executes an action. There are several actions that can be configured, as shown below:

1. Reduce Brightness
2. Lock Screen
3. Notification

Examples

• The application detects the faces in different positions and even if someone is hidden behind a hand.

• Notification sent after detecting shoulder surfing.

Getting Started

These instructions will get you a copy of the project up and running on your local machine.

Prerequisites

It's necessary to have node (>9) and npm(>5) installed. (It has been tested with node 9.11.2 and npm 5.6.0)

• Node and NPM
• Node v9.11.2 and npm v5.6.0 for Windows

* Check Installed Versions * 
npm -v
node -v

Installing

Dependencies installation

* LINUX AND MAC * 
npm install

* WINDOWS * 
Install python 2.7 (https://www.python.org/ftp/python/2.7.15/python-2.7.15.amd64.msi)
*Open the Control Panel (easy way: click in the Windows search on your task bar, type “Control Panel,” then click the icon).
*In the Control Panel, search for Environment; click Edit the System Environment Variables. Then click the Environment Variables button.
*In the System Variables section, you will need to either edit an existing PATH variable. If you’re editing an existing PATH, the values are presented on separate lines in the edit dialog. Add python path Ex: C:\Python27 
*Open CMD and check python is installed with the command python --version

Install node dependency
* npm install -g node-gyp
Install node package for windows (It takes a while, be patient)
* npm install --global --production windows-build-tools 

Install project dependencies
* npm install 

How to run

npm run electron:serve

How to build

npm run electron:build

Extending actions

For implementing new actions it is necessary to modify the file src/utils/actions.js.

1. Add the action name to the list this.availableActions.
2. Create one the function with the funcionallity to launch the action.
3. Add the function to the executeAction() function.
4. If it's necessary, create a function to reverse the action and add it to the reverseAction() function.

Built with

• Electron - The Framework used for creating the multiplatform app
• VueJS - Progressive JavaScript Framework
• PugJS - Template Engine
• SASS - CSS extension language
• Face-api.js - Used for face detenction

Authors

• Nerea Sainz De La Maza (@nereasainzdelamaza)
• José Ignacio Escribano (@jiep)
• Jorge Cuadrado Sáez (@jorcuad)
• Ruth González Novillo (@RuthGnz)

License

This project is licensed under the MIT License - see the LICENSE file for details