nvdnkpr / securely

BenCoding.Securely

Securely provides building blocks to create secure Titanium apps.

The following proxy objects allow for you to build a composible cross-platform security layer to meet your various security requirements.

Before you start

* These are iOS and Android native modules designed to work with Titanium SDK 3.0.0.GA * Before using this module you first need to install the package. If you need instructions on how to install a 3rd party module please read this installation guide.

Download the compiled release

Download the platform you wish to use:

• iOS Dist
• Android Dist

Building from source?

If you are building from source you will need to do the following:

Import the project into Xcode:

• Modify the titanium.xcconfig file with the path to your Titanium installation

Import the project into Eclipse:

• Update the .classpath
• Update the build properties

Setup

• Download the latest release from the releases folder ( or you can build it yourself )
• Install the bencoding.securely module. If you need help here is a "How To" guide.
• You can now use the module via the commonJS require method, example shown below.

var securely = require('bencoding.securely');

Creating the Securely Module Object

Requiring the module into your project

//Require the securely module into your project
var securely = require('bencoding.securely');

Secure Properties

The Securely Properties module is used to store values in the KeyChain using the same API as Titanium.App.Properties.

To learn more about this part of the module, please view the documentation here.

---

Key Generators

Securely provides the ability to generator random and derived keys. These key generators allow you to generate strong passwords for your encryption functions.

To learn more about this part of the module, please view the documentation here.

---

String Crypo

Securely provides the ability to encrypt and decrypt JavaScript strings and JSON objects through a variety of algorithms.

To learn more about this part of the module, please view the documentation here.

---

File Crypo

Securely provides the ability to encrypt and decrypt local device files.

To learn more about this part of the module, please view the documentation here.

---

iOS PDF Locker

On iOS Securely provides the ability to password protect and unlock PDF documents.

To learn more about this part of the module, please view the documentation here.

---

Dependent Projects

Securely uses several wonderful open source projects. I highly encourage you to check them out using the information below.

JSONKit

Project: http://github.com/johnezang/JSONKit

PDKeychainBindingsController

Project: https://github.com/carlbrown/PDKeychainBindingsController

Licensing & Support

This project is licensed under the OSI approved Apache Public License (version 2). For details please see the license associated with each project.

Developed by Ben Bahrenburg available on twitter @benCoding

Learn More

Examples

Please check the module's example folder or [github repo](https://github.com/benbahrenburg/Securely/tree/master/iOS/example) for samples on how to use this project.

Twitter

Please consider following the @benCoding Twitter for updates and more about Titanium.

Blog

For module updates, Titanium tutorials and more please check out my blog at benCoding.Com.