cloak
=====

Download URL target encrypted then compressed and base64 encoded as
DATA.txt file.

Target URL is expected to be base64 encoded zlib compressed AES
encrypted URL. URL can be prepared using this same tool (see usage
below).
URL content is fetched and then AES encrypted, zlib compressed and
base64 encoded. Content is downloaded as DATA.txt. It can be
decoded, uncompressed and decrypted using this same tool (see usage
below).
Content size can be limited.
It uses lock which allows only one request at a time.
It is implemented with bottle microframework.
It is a hack! :)

Usage
=====

Print usage:

.. code:: bash

    python x.py -h

Prepare target URL:

.. code:: bash

    python x.py c TARGET
    python x.py c 'http://www.google.com'

Decode, decompress and decrypt target content saved as DATA.txt and
save it to data.tar.xz:

.. code:: bash

    cat DATA.txt | python x.py d > data.tar.xz

Run it in development mode:

.. code:: bash

    python x.py ANY-ARG
    python x.py x

Run it in production mode:

.. code:: bash

    python x.py

When you use this same tool for prepareing target URL and decrypting
target content on the client then x.py need to be defined with the same AES
KEY and IV values as on the server.

Installation
============

Copy bottle.py and x.py to the desired server and directory and run it.

Documentation
=============

this README.rst, code itself, docstrings

It can be found on github.com at:

https://github.com/darko-poljak/cloak

Tested With
===========

Python2.7, Python3.4

Further development ideas
=========================

* Implement key, iv rotation or something similar.

* Add configuration file.

* Add apache mod_wsgi support.

* Support defined maximum requests at a time instead of one lock.