Skip to content

Latest commit

 

History

History
89 lines (58 loc) · 5.1 KB

README.md

File metadata and controls

89 lines (58 loc) · 5.1 KB

Encryptr

Encryptr is a zero-knowledge, cloud-based e-wallet / password manager powered by Crypton.

It started as an example project for seeing what Crypton could do in a Apache Cordova mobile app. I had a particular itch to scratch. I got tired of trying to remember my work password. It changes fairly often, is slightly complex and is generated – I can't choose it for myself.

I had tried a few password managers but hadn't loved any of them – particularly on Android. So, when I needed an idea of an app to make to try out Crypton, this seemed like an obvious choice. At its simplest, Crypton is basically a cloud based key/value store using end to end zero-knowledge encryption. None of the data stored on the server can be viewed by the server.

I wanted something to store hard to remember passwords, important numbers, etc across devices.

Encryptr keeps it simple. It has three types of data it can store. Passwords, Credit Card numbers and general key/value pairs. It can easily be expanded to include other default entry types.

It is currently working on Android, and the Desktop – thanks to NW.js – but there are no reasons why it could not by expanded to Blackberry10 and Windows Phone 8.

iOS is coming soon, just waiting on a way to either make it work with the new WKWebview or to push some of the hard crypto to native.

screenshot

Bitcoin donations accepted

1M6sUtHuYo9eF1GUdPJfy374K3CqyPw3sV

Requirements

Getting started

  • clone the project
  • cd into the project folder
  • npm install to install node_modules and js/css components (npm install will also run bower install).
  • cordova platform add ios and/or cordova platform add android
  • cordova-icon && cordova-splash

First test

To make sure everything is set up from the above, run your first tests:

grunt test

See the output for the steps taken to produce the working test rig. Most of the steps have grunt commands you can use to do them individually.

Workflow

JavaScript files are in src. They are kept out of the www tree so that they can be linted without trying to lint the concatenated and minified versions. However, the index.html should have a script tag only for the JavaScript files in either components (managed by Bower) or www/js.

Building and testing the project is normally done via the Grunt tasks below.

Grunt tasks

We use grunt commands to do most of the project operations, like:

  • running the app:

    • ios: grunt debug:ios
    • Android: grunt debug:android
  • testing: grunt test

  • linting the sources: grunt jshint

  • concatenating the sources: grunt concat

  • compiling the templates: grunt dot

See the steps taken for grunt test and grunt debug:XXX for the various operations needed to constitute the working app, and look at Gruntfile.js for the whole repertoire.

Cryptography Notice

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org/ for more information.

The U.S. Government Department of Commerce, Bureau of Industry and Security (BIS), has classified this software as Export Commodity Control Number (ECCN) 5D002.C.1, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this distribution makes it eligible for export under the License Exception ENC Technology Software Unrestricted (TSU) exception (see the BIS Export Administration Regulations, Section 740.13) for both object code and source code.

License