A Django model field that encrypt your data when save to and decrypt when get from database. It keeps data always encrypted in database.
Project description
# django-mirage-field
![](https://img.shields.io/pypi/v/django-mirage-field.svg?label=django-mirage-field)
## Introduce
A Django model field that encrypt your data when save to and decrypt when get from database. It keeps data always encrypted in database. Base on symmetric encryption, it support query the origin text and return encrypted objects in Django.
## Support
* Use settings.SECRET_KEY as secret key default or anyelse which length >= 32
* Support CharField、TextField、IntegerField、EmailField
* Support Django ORM's `get()`、`filter()` query method
* Use AES-256-ECB algorithm
* Support PostgreSQL and MySQL database
* Support Django model field `db_index` and `unique` attributes
## Installation
```bash
pip install django-mirage-field
```
## Usage
```python
from mirage import fields
class TestModel(models.Model):
phone = fields.EncryptedIntegerField()
```
```python
obj = TestModel.objects.get(phone=18866677777)
obj.id # 123
obj.phone # 18866677777
type(obj.phone) # int
```
```psql
database=# select * from testmodel where id = 123;
id | phone
---------------------+--------------------------
123 | -bYijegsEDrmS1s7ilnspA==
```
```python
from mirage.crypto import Crypto
c = Crypto(key="") # key is optional, default will use settings.SECRET_KEY
c.encrypt('18866677777') # -bYijegsEDrmS1s7ilnspA==
c.decrypt('-bYijegsEDrmS1s7ilnspA==') # 18866677777
```
## Model Fields
1. EncryptedTextField
2. EncryptedCharField
3. EncryptedEmailField
4. EncryptedIntegerField
## Data Migrate
Add`mirage`to`INSTALLED_APPS`
### 1. Migrations
add `app_name`,`model_name`,`field_name` in [migrations.RunPython](https://docs.djangoproject.com/en/2.2/ref/migration-operations/#runpython)
```
from mirage.tools import Migrator
migrations.RunPython(Migrator("app_name", "model_name", "field_name").encrypt, reverse_code=Migrator("app_name", 'model_name', 'field_name').decrypt),
```
### 2. Commands
Options:
* --app
* --model
* --field
* --method (optional: `encrypt`, `decrypt`, `encrypt_to`, `decrypt_to`, `copy`)
* --tofield (need when use `encryt_to`, `decrypt_to`, `copy` method)
Optional options:
* --offset ("select * from xxx where id > offset")
* --total ("select * from xxx order by id limit total")
Examples
```
./manage.py mirage --app=yourapp --model=testmodel --field=address --method=encrypt --offset=2000000 --total=3000000
./manage.py mirage --app=yourapp --model=testmodel --field=address --method=encrypt_to --tofield=encrypted_address
```
## Exceptions
```
from mirage import exceptions
```
1. EncryptedFieldException
## Performance
Migrate data: 6000,000 columns takes 40 minutes, Average 1 column/2.5ms
Only encrypt/decrypt: Average 1 value/ms
## Clients
* [Java](https://github.com/luojilab/django-mirage-field/tree/master/client/java)
![](https://img.shields.io/pypi/v/django-mirage-field.svg?label=django-mirage-field)
## Introduce
A Django model field that encrypt your data when save to and decrypt when get from database. It keeps data always encrypted in database. Base on symmetric encryption, it support query the origin text and return encrypted objects in Django.
## Support
* Use settings.SECRET_KEY as secret key default or anyelse which length >= 32
* Support CharField、TextField、IntegerField、EmailField
* Support Django ORM's `get()`、`filter()` query method
* Use AES-256-ECB algorithm
* Support PostgreSQL and MySQL database
* Support Django model field `db_index` and `unique` attributes
## Installation
```bash
pip install django-mirage-field
```
## Usage
```python
from mirage import fields
class TestModel(models.Model):
phone = fields.EncryptedIntegerField()
```
```python
obj = TestModel.objects.get(phone=18866677777)
obj.id # 123
obj.phone # 18866677777
type(obj.phone) # int
```
```psql
database=# select * from testmodel where id = 123;
id | phone
---------------------+--------------------------
123 | -bYijegsEDrmS1s7ilnspA==
```
```python
from mirage.crypto import Crypto
c = Crypto(key="") # key is optional, default will use settings.SECRET_KEY
c.encrypt('18866677777') # -bYijegsEDrmS1s7ilnspA==
c.decrypt('-bYijegsEDrmS1s7ilnspA==') # 18866677777
```
## Model Fields
1. EncryptedTextField
2. EncryptedCharField
3. EncryptedEmailField
4. EncryptedIntegerField
## Data Migrate
Add`mirage`to`INSTALLED_APPS`
### 1. Migrations
add `app_name`,`model_name`,`field_name` in [migrations.RunPython](https://docs.djangoproject.com/en/2.2/ref/migration-operations/#runpython)
```
from mirage.tools import Migrator
migrations.RunPython(Migrator("app_name", "model_name", "field_name").encrypt, reverse_code=Migrator("app_name", 'model_name', 'field_name').decrypt),
```
### 2. Commands
Options:
* --app
* --model
* --field
* --method (optional: `encrypt`, `decrypt`, `encrypt_to`, `decrypt_to`, `copy`)
* --tofield (need when use `encryt_to`, `decrypt_to`, `copy` method)
Optional options:
* --offset ("select * from xxx where id > offset")
* --total ("select * from xxx order by id limit total")
Examples
```
./manage.py mirage --app=yourapp --model=testmodel --field=address --method=encrypt --offset=2000000 --total=3000000
./manage.py mirage --app=yourapp --model=testmodel --field=address --method=encrypt_to --tofield=encrypted_address
```
## Exceptions
```
from mirage import exceptions
```
1. EncryptedFieldException
## Performance
Migrate data: 6000,000 columns takes 40 minutes, Average 1 column/2.5ms
Only encrypt/decrypt: Average 1 value/ms
## Clients
* [Java](https://github.com/luojilab/django-mirage-field/tree/master/client/java)
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Close
Hashes for django-mirage-field-0.0.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b703cf5ae9a700bd701fa5cdcd85aa932c829a41bf9d9abd646cab0eb74a5e86 |
|
MD5 | 09af190f6b0131299c875b38ad2f3f91 |
|
BLAKE2b-256 | 0d0c6fd6cfc2c57538d2c10282cfd337681a390c722f7274b8dfa10be89d06cf |