AWS configuration

1. Create an S3 bucket.

2. Generate a keypair for the user that can access the bucket.

3. Create a cloudfront distribution that has origin in the bucket and is restricted to signed URLs.

4. (for protected mode) Generate a cloudfront keypair that can be used in

   the distribution.

Installation

1. Install djamazing by pip:

   $ pip install djamazing

   NOTE: If you are using djamazing with Django 1.10 you need a yet unpublished version of django-threadlocals:

   $ pip install git+https://github.com/nebstrebor/django-threadlocals.git

2. Set "djamazing.storage.DjamazingStorage" as your DEFAULT_FILE_STORAGE.

3. Configure Djamazing:

   DJAMAZING = {
       'CLOUDFRONT_KEY': b"""-----BEGIN RSA PRIVATE KEY-----
   (...)
   -----END RSA PRIVATE KEY-----""",
       'CLOUDFRONT_KEY_ID': '...',
       'CLOUDFRONT_URL': 'http://....cloudfront.net/',
       'S3_KEY_ID': '...',
       'S3_SECRET_KEY': '...',
       'S3_BUCKET': '...',
       'SIGNATURE_TIMEOUT': datetime.timedelta(seconds=2),
   }

   For unprotected mode omit the CLOUDFRONT_KEY and CLOUDFRONT_KEY_ID keys. If you want to store a cloudfornt key in the file CLOUDFRONT_KEY_FILE parameter may be also used with file path. Note that the SIGNATURE_TIMEOUT is the time that doesn’t require any human interaction, only the browser to handle the redirection. If unspecified - it defaults to 1.5 second.

4. Add threadlocals middleware 'threadlocals.middleware.ThreadLocalMiddleware' to your MIDDLEWARE

5. Add djamazing URLs to urls.py:

   url(r'^djamazing/', include(djamazing.urls)),

Using various configurations in one project

If you want to use various configurations in one project (e.g. unprotected for static file and protected for uploads), you can use inheritance. Create a simple subclass of DjamazingStorage like:

class StaticStorage(DjamazingStorage):
    """Storage for static files"""

    def __init__(self):
        super(StaticStorage, self).__init__(settings.STATIC_DJAMAZING)

now you can use it as your storage like:

STATICFILES_STORAGE = 'some.path.StaticStorage'
STATIC_DJAMAZING = { ... }

and the STATIC_DJAMAZING configuration would override DJAMAZING configuration for this storage.