#summary An introduction to the Baja project.

= Introduction =

Baja provides a simple 100% pure Java interface to the box.net file storage and sharing platform.

= Goals =

The goal of the Baja project is to provide an simple Java interface to all of the functionality in the Box API. Baja is currently in a pre-release state and does not yet implement the entire Box API.

= License =

Baja is an open source project provided under the Apache 2.0 license.

= Releases =
Baja releases contain all available documentation and example code as well as all of the required Baja and third party binaries. Releases can be downloaded [http://code.google.com/p/baja/downloads/list here] and all of the source code can be found [http://code.google.com/p/baja/source here].

= Documentation =
The API documentation for the current release can be viewed online (it is also included in the release). The examples included in the release demonstrate all of the currently available functionality.

= Security =
The Box file sharing platform is inherently insecure. Login credentials and auth tokens are transmitted over the Internet in the clear and files are transfered without any encryption. Box is not designed to keep private data secure and it should not be used in such a manner. Baja currently uses a caching authenticator, which writes all usernames and passwords to a file named .box in the user's home directory. Future releases of Baja will not enable this functionality by default. The logs that Baja writes are currently not sanitized properly and contain private information such as passwords and auth tokens. Future releases of Baja will correct this as well.

= Requirements =

In order to use Baja, you will need a box.net account. Visit [http://www.box.net box.net] to open an account. Accounts with limited storage and functionality are available free of charge, larger and more feature-rich accounts are available for purchase.

== Runtime Requirements ==
  * [http://java.sun.com/javase/downloads/index_jdk5.jsp Java 5.0 or later]
  * Jakarta [http://commons.apache.org/beanutils/ commons-beanutils 3.2]
  * Jakarta [http://commons.apache.org/codec/ commons-codec 1.3]
  * Jakarta [http://commons.apache.org/httpclient/ commons-httpclient 3.1]
  * Jakarta [http://commons.apache.org/logging/ commons-logging 1.1]
  
== Build time Requirements ==
  * All of the above
  * JUnit [http://www.junit.org/ JUnit 4.4]
  * EasyMock [http://www.easymock.org/ easymock 2.3]