django-nacl-fields 3.0.0

About PyNaCl

PyNaCl is a Python binding to libsodium, which is a fork of the Networking and Cryptography library. These libraries have a stated goal of improving usability, security and speed.

Getting Started

~ pip install django-nacl-fields

Create a key to be used for encryption:

~ python manage.py createkey
# put the following line in your settings.py:
NACL_FIELDS_KEY = b'p1Et2Rb@;^BYdo`ZRFi!Hc-MXu(^|bVqA-FGqffM'

In your settings.py:

NACL_FIELDS_KEY = b'p1Et2Rb@;^BYdo`ZRFi!Hc-MXu(^|bVqA-FGqffM'

Then, in your models.py:

from django.db import models
from nacl_encrypted_fields import NaClTextField


class MyModel(models.Model):
        text_field = NaClTextField()

Use the model as you would normally and the data will be stored encrypted in the database.

Note: Encrypted data cannot be used to query or sort. In SQL, these will all look like text fields with random text.

It is also possible to append the fields key to your settings file automatically upon creation, by using the -f flag:

~ python manage.py createkey -f settings.py

Where settings.py is the path to your settings file.

Available Fields

Currently build-in and unit-tested fields.

• NaClCharField

• NaClTextField

• NaClDateTimeField

• NaClIntegerField

• NaClFloatField

• NaClEmailField

• NaClBooleanField

Encrypt Your Own Fields

Making new fields can be done by using the provided NaClFieldMixin:

from django.db import models
from nacl_encrypted_fields import NaClFieldMixin

class NaClIPAddressField(NaClFieldMixin, models.IPAddressField):
        pass

Please report any issues you encounter when trying this.

References

• https://github.com/defrex/django-encrypted-fields

• https://github.com/orcasgit/django-fernet-fields