Django-bcrypt技术文档

1. 安装指南

安装django-bcrypt非常简单，您可以使用pip工具，通过以下命令安装：

pip install -e hg+http://bitbucket.org/dwaiter/django-bcrypt#egg=django-bcrypt

或者如果您更倾向于使用Git，可以使用以下命令：

pip install -e git://github.com/dwaiter/django-bcrypt.git#egg=django-bcrypt

2. 项目的使用说明

在您的Django项目中，首先需要将django_bcrypt添加到INSTALLED_APPS设置中。这样，任何新设置的密码都将使用bcrypt进行哈希处理。旧密码仍将正常工作。

INSTALLED_APPS = [
    # ...
    'django_bcrypt',
    # ...
]

3. 项目API使用文档

django-bcrypt提供了几个设置选项，您可以在settings.py文件中进行配置：

• BCRYPT_ENABLED：当调用User.set_password()时，启用bcrypt哈希。

  • 默认值：True

• BCRYPT_ENABLED_UNDER_TEST：在Django测试用例内运行时，启用bcrypt哈希。

  • 默认值：False（为了加快用户创建速度）

• BCRYPT_ROUNDS：bcrypt哈希要使用的轮数。随着计算机性能的提高，您可以增加这个数值。

  • 默认值：12

• BCRYPT_MIGRATE：在调用check_password()时，启用bcrypt密码迁移。

  • 默认值：False

4. 项目安装方式

项目可以通过两种主要方式安装：

• 通过pip安装Mercurial版本：

pip install -e hg+http://bitbucket.org/dwaiter/django-bcrypt#egg=django-bcrypt

• 通过pip安装Git版本：

pip install -e git://github.com/dwaiter/django-bcrypt.git#egg=django-bcrypt

通过以上步骤，您可以轻松地将django-bcrypt集成到您的Django项目中，从而提高密码存储的安全性。