djassr 0.1.1

Django AWS S3 Signed Requests API with Django Rest Framework

Django rest framework views to get a S3 signed url to PUT or GET to AWS S3

Note

This views doesn’t provide any authentication nor permission classes. This means that ANYONE can have access to them if your API is public. It’s highly recomended to add authentication_classes and permission_classes.

Example views.py

import djassr

class MyS3PUTSignatureAPIView(djassr.GetPUTSignature):
    authentication_classes = (TokenAuthentication, )
    permission_classes = (IsAuthenticated,)

Note

File names are replaced by a uuid.uuid4 + the extension. For example “myfile.png” will become “7afad9bc-00d3-46ed-86bf-5ccc52eebd50.png”.

Note

The duration of the link is by default 60 seconds. To change this you can overwrite the get_valid method for the signature class. It must return an integer wich is the time in seconds the link will be valid.

Install

$ pip install djassr

Usage

In urls.py

...
url('^put_signed_url/$', djassr.views.GetPUTSignature.as_view()),
...

Demo

You can look at and run the demo project.

pip install -r requirements-dev.txt
pip install -e ../
cd demop
python manage.py migrate
python manage.py runserver

Go to http://localhost:8000/api/