功能特性

• 多版本支持, 同时支持Python2和Python3

• 使用简单, 只需配置好两个配置项就可以工作, 同时自带了登录表单

• 灵活性高, 你可以自定义可用的校区, 认证成功或失败时所进行的操作

• 侵入性小, 你几乎不需要怎么修改你的代码逻辑就能集成基于合工大教务信息的学生身份认证

• 可用性强, 只有在其他认证方式失败同时提供的认证信息格式正确时才会向教务系统发送请求, 避免了错误的用户输入和高频操作导致的IP锁定问题

django>=1.9
hfut-stu-lib>=1.4.1

安装

你只需要在命令行下输入一下代码便能安装好 django-hfut-auth:

$ pip install django-hfut-auth

如果你没有安装 pip ， Python 安装包指南 能够指导你安装 PIP .

配置

settings.py:

INSTALLED_APPS = (
    ...
    # 必要的 APP
    'django.contrib.auth',
    'django.contrib.contenttypes',
    # 添加 APP
    'hfut_auth',
    ...
)
AUTHENTICATION_BACKENDS = (
    ...
    # 必要的认证后端
    'django.contrib.auth.backends.ModelBackend',
    # 将 HFUTBackend 放在 ModelBackend 后面, 确保先从本地数据库认证
    'hfut_auth.backends.HFUTBackend',
    ...
)

# 其他配置, 右侧为默认值
# 支持认证的校区, 宣城校区为'XC', 合肥校区为'HF', 所有校区为'ALL'
HFUT_AUTH_CAMPUS = 'ALL'

使用

配置完成后, 按照一般的认证方式认证即可. 注意当 HFUT_AUTH_CAMPUS = ‘ALL’ 时, 调用 django.contrib.auth.authenticate 需要提供 campus 参数指明是哪个校区.

相应的, 它提供了 hfut_auth.forms.AuthenticationForm , 它集成自 django.contrib.auth.forms.AuthenticationForm , 能够自动的根据配置添加 campus 表单字段, 其他的与父类没有任何区别.

开发日志

0.1.2 (2016-08-25)

• 由于 django 1.9 版本只支持 Python 2.7, 3.4, 3.5 版本, 相应的移除了 Python 3.3 的支持

• 更新了文档