djangosecure

Secure Django settings (Works with other Python scripts)

This module creates a cryptokey outside the django project directory, encrypts with that cryptokey your django sensible settings and stores the encrypted values.

You can use it at your project settings.py file

• Note: Before running the django site with gunicorn or similar for the first time, you must run somme manage command to be prompt for the sensible settings
• Developed for Linux/Python2.7, Python3.5

Install

Linux required packages: python-dev (python3.5-dev if python==3.5) libgmp-dev gcc pip install djangosecure

Examples

SECRET_KEY

settings.py

from djangosecure import DjangoSecretKey


SECRET_KEY_FILE_PATH = '/some/path/to/store/file.secret'
secret_key = DjangoSecretKey(SECRET_KEY_FILE_PATH)
SECRET_KEY = secret_key.key

• Note: If the secret key file path does not exist it will try to create it. (write permissio required @SECRET_KEY_FILE_PATH origin)
• Note: The secret file will be automatically created the first time you call secret_key.key
• The cryptographic key is stored by default at ~/.private/django_secure.key you can change this by passing crypto_key_file= to the DjangoSecretKey constructor: secret_key = DjangoSecretKey(SECRET_KEY_FILE_PATH, crypto_key_file='path/to/your/cryptokey') DjangoDatabaseSettings and EncryptedStoredSettings accept crypto_key_file parameter too.

DATABASES

The first time you run python manage.py runserver you will be prompted for your database settings. They will be saved encrypted with the generated cryptokey generated by django-secure module.

You can have as many database configurations, change the parameter to change the configuration and running python manage.py runserver you will be prompted again for the new settings

from djangosecure import DjangoDatabaseSettings
databases = DjangoDatabaseSettings(os.path.join(PROJECT_ROOT, 'databases.cnf'), crypto_key_file='path/to/your/cryptokey)

DATABASES = {
    'default': 'default': databases.settings('production'),
}

Other settings

To encrypt any other setting use EncryptedStoredSettings, for example:

from djangosecure import EncryptedStoredSettings
encripted_settings = EncryptedStoredSettings('./hidden/settings/path'))

CELERY_BROKER = 'amqp://{0}:{1}@localhost//'.format(
    encripted_settings.get('celery', 'broker_username', config_file="config/file/path/here.cfg"),
    encripted_settings.get('celery', 'broker_password')
    )

Runing tests

nosetests --with-coverage --cover-html
nosetests --with-coverage --cover-html --cover-inclusive --cover-package=djangosecure

• Note: File and path are automatically created at first call