comk-django-account 1.0.4

1. model构建

1. 先在settings中进行配置:

   INSTALLED_APPS = [
       'django.contrib.admin',
       'django.contrib.auth',
       'django.contrib.contenttypes',
       'django.contrib.sessions',
       'django.contrib.messages',
       'django.contrib.staticfiles',
       'comk_django_account.apps.ComkDjangoAccountConfig', # 加上这一行
   ]
   

2. 再执行 migrate 命令:

   python manage.py
   

2. 添加账户

1. 在urls.py下加上url配置:

   from django.conf.urls import url, include
   from django.contrib import admin
   
   urlpatterns = [
       url(r'^admin/', admin.site.urls),
       url(r'^', include('comk_django_account.urls')),
   ]
   

2. 通过API创建账户:

   url= '/acount_action/'
   request_data = dict(
       method='account.add', # 必传参数
       description='测', # 账户描述
       appid='381', # 账户id
       pri_key=pri_key, # 私钥
       own_public_key=own_public_key, # 公钥
       other_public_key=other_public_key, # 对方公钥
   )
   request.post(url,json=request_data)
   

3. 设置加密解密Key

对于某些数据来说，是非常重要的，那么就不能明文存储在数据库中，必须加密存储，而且，为了方便使用，必须是可逆加密。

在此使用的加密算法是AES对称加密，这就涉及到一个问题，Key的值。

这里使用了一个默认的值，但是对于生产的项目来说，不建议使用默认的值，在此提供一个设置该Key值的方法，需要在setting文件中配置，如下:

setting.py

from comk_django_account import set_account_aes_key
set_account_aes_key(Key)  # Key值在本包内，限定为32位。

4. 权限校验

1. 对于服务方来说，这里提供一个默认的权限校验方式，只需要加上装饰器即可，使用方法如下:

   from comk_django_account.views.utils.app_check import request_to_response
   @method_decorator(request_to_response, name='dispatch')  # 用户访问权限校验，以及业务正常失败处理
   class Server(View):
       """
       提供的服务
   
       """
   

2. 默认的权限校验方式的要求:

   1. 权限校验必须限定为POST请求，且交互数据必须是JSON字符串。
   2. 必须有appid、method、timestamp、content、sign字段
   3. timestamp的格式为'2019-01-01 00:00:00'
   4. content必须是键值对
   5. 该装饰器已经确定返回JsonResponse，因为原Server只需要返回dict数据就行，装饰器会进行封装
   

3. 可以根据此检验方式实现自己的权限校验方法

5. 调用服务

1. 与上面的默认权限校验相对，对于调用方来说，需要加签名通过认证:

   from comk_django_account.views.utils.sign_utils import get_sign
   def get_sign(pri_key, r_data):
       '''
       获取签名
   
       :param pri_key: 私钥
       :param r_data: 一个dict数据
       :return:
       '''
   
   取得键为sign、值为签名值的键值对
   

2. 为方便调用者，可使用 params_utils 下的 build_request_params 或 make_params_with_sign 方法，直接构造出请求数据。

6. 其他

需要注意的是，权限校验与调用方法是需要对应的。例如，服务方单独实现了一个校验方法，而调用方使用默认的加签方法，这是不行的。