https://github.com/gsteixeira/django-filefield-encrypted

Encrypted file field for django
https://github.com/gsteixeira/django-filefield-encrypted

Last synced: about 5 hours ago
JSON representation

Encrypted file field for django

• Host: GitHub
• URL: https://github.com/gsteixeira/django-filefield-encrypted
• Owner: gsteixeira
• License: gpl-3.0
• Created: 2023-12-27T15:19:21.000Z (10 months ago)
• Default Branch: main
• Last Pushed: 2024-01-02T17:33:31.000Z (10 months ago)
• Last Synced: 2024-10-10T14:19:43.706Z (27 days ago)
• Language: Python
• Size: 33.2 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
DJANGO FILE FIELD ENCRYPTED

---------------------------

django-filefield-encrypted - An encrypted file field for Django.

This will encrypt when saving and decrypt on reading files on the fly.

Files will be stored in a directory other than MEDIA_ROOT, so not exposed through 'media/...'.

INSTALLATION

------------

Install django-filefield-encrypted:

.. code:: shell

    pip install django-filefield-encrypted

Then add to your settings.py:

.. code:: python

    # the key to encrypt the files. Keep it safe!

    ENCRYPTED_FILES_KEY = b""

    # The directory where files will be stored.

    SAFE_MEDIA_ROOT = BASE_DIR / "safe/"

You can generate a key with:

.. code:: python

    from cryptography.fernet import Fernet

    key = Fernet.generate_key()

    print(key)

USAGE

-----

In your models.py:

.. code:: python

        from encrypted_files.fields import EncryptedFileField

        class Foobar(models.Model):

            foo = EncryptedFileField(upload_to="whatever/")

You can create your records normally. To read the file contents:

.. code:: python

        from encrypted_files.fields import EncryptedFileField

        obj = Foobar.objects.get(pk=pk)

        with obj.foo.open(mode="rb") as f:

            content = f.read()

To retrieve the contents of the file in a view:

.. code:: python

        from encrypted_files.views import EncryptedFileDetailView

        class FoobarView(EncryptedFileDetailView):

            model = Foobar

            encrypted_file_field = "foo"

Add this view to your urls.py. When you go to that url it will return the plain contents of the file. Treat if like a ´django.views.generic.detail.DetailView´.

All you need is to indicate the model and the ´encrypted_file_field´ which is the field that contains the encrypted file.

So let's say you want to store an image, and use it in your html. Given the above example. This is how the template would look like:

.. code:: html

        

That's it! The rendering page will load the image from that url, that will return the contents of the encrypted file transparently.

Alternatively you can also use it to download the file, in your template add the download link:

.. code:: html

        

            click here...