Python | Django-allauth 设置和配置

Django-allauth 是一个基于 Django 的第三方认证应用，它提供了社交媒体认证（如 GitHub、Twitter、Facebook 等），邮箱验证，重置密码等基本认证功能。在本文中，我们将学习如何设置和配置 Django-allauth。

安装 Django-allauth

在使用 Django-allauth 之前，我们必须先安装它。一种简单的方法是使用 pip 工具：

pip install django-allauth

添加 Django-allauth 到 INSTALLED_APPS

接下来，我们需要将 Django-allauth 添加到 Django 的安装应用列表中。打开项目的 settings.py 文件，在 INSTALLED_APPS 列表中添加 'allauth' 和 'allauth.account' 应用：

# settings.py

INSTALLED_APPS = [
    # ...
    'django.contrib.sites',
    'allauth',
    'allauth.account',
    # ...
]

配置 AUTHENTICATION_BACKENDS

打开项目的 settings.py 文件，在 AUTHENTICATION_BACKENDS 列表中添加一下代码：

# settings.py

AUTHENTICATION_BACKENDS = [
    'django.contrib.auth.backends.ModelBackend',
    'allauth.account.auth_backends.AuthenticationBackend',
]

这样就启用了 allauth 的权限后端，使我们能够使用 allauth 带来的所有功能。

配置 SITE_ID

打开项目的 settings.py 文件，并添加 Site 应用：

# settings.py

INSTALLED_APPS = [
    # ...
    'django.contrib.sites',
    # ...
]

SITE_ID = 1

如果你没有安装 Sites 的话，可以使用以下命令添加它：

python manage.py migrate sites

配置 URL

为了使用 allauth，我们需要添加 URLconf。打开项目的 urls.py 文件，并添加以下代码：

# urls.py

urlpatterns = [
    # ...
    path('accounts/', include('allauth.urls')),
    # ...
]

这个 URL 映射将启用 Django-allauth 的认证视图和模板。

配置 AUTH_USER_MODEL

为了使用 Django-allauth，我们需要将 AUTH_USER_MODEL 配置为你要使用的用户模型。打开 projects/settings.py 文件，并将 AUTH_USER_MODEL 设置为你的用户模型的路径。

# settings.py

AUTH_USER_MODEL = 'my_app.MyUserModel'

配置 EMAIL_BACKEND

如果你要使用邮箱验证，则需要配置 EMAIL_BACKEND。打开项目的 settings.py 文件，并添加以下内容：

# settings.py

EMAIL_BACKEND = 'django.core.mail.backends.smtp.EmailBackend'
EMAIL_HOST='smtp.gmail.com'
EMAIL_PORT=587
EMAIL_USE_TLS=True
EMAIL_HOST_USER='your_email@gmail.com'
EMAIL_HOST_PASSWORD='your_gmail_password'

以上代码是针对 G-mail 的。你需要将 EMAIL_HOST_USER 和 EMAIL_HOST_PASSWORD 更改为你的用户名和密码，并将 EMAIL_BACKEND 设置为你的邮件服务提供商的后端。

启用社交媒体登录

Django-allauth 默认情况下提供许多社交媒体登录选项，例如 GitHub，Twitter 和 Facebook。要启用社交媒体登录，只需在 Django-allauth 后台管理页面的“社交账户提供商”下启用它们即可。

结论

到此为止，我们已经成功配置了 Django-allauth。它现在应该可以处理所有的认证任务，包括邮箱验证和社交媒体登录。在实际开发中，我们可以根据实际需要自定义 Django-allauth 的用户界面和行为。