使用 Django 的验证系统Link to this heading#

选择认证后端Link to this heading#

当用户登录时，用户的 ID 和用于认证的后端被保存在用户的会话中。这允许相同的 认证后端 在将来的请求中获取用户的详细信息。要保存在会话中的认证后端是按以下方式选择的：

1. 使用可选的 backend 参数的值，如果提供了的话。

2. 使用 user.backend 属性的值，如果存在的话。这允许将 authenticate() 和 login() 配对使用： authenticate() 会在返回的用户对象上设置 user.backend 属性。

3. 如果只有一个 AUTHENTICATION_BACKENDS 中的后端，则使用其中的后端。

4. 否则，抛出一个异常。

在情况 1 和情况 2 中，backend 参数的值或 user.backend 属性应该是一个点分路径字符串（类似于 AUTHENTICATION_BACKENDS 中的路径），而不是实际的后端类。

原始方式Link to this heading#

限制访问页面的原始方法是检查 request.user.is_authenticated 并且要么重定向到登录页面：

from django.conf import settings
from django.shortcuts import redirect


def my_view(request):
    if not request.user.is_authenticated:
        return redirect(f"{settings.LOGIN_URL}?next={request.path}")
    # ...

...或者显示一个错误消息：

from django.shortcuts import render


def my_view(request):
    if not request.user.is_authenticated:
        return render(request, "myapp/login_error.html")
    # ...

login_required 装饰器Link to this heading#

login_required(redirect_field_name='next', login_url=None)Link to this definition#

作为一种快捷方式，你可以使用方便的 login_required() 装饰器：

Code

from django.contrib.auth.decorators import login_required


@login_required
def my_view(request): ...

login_required() 会执行以下操作：

• 如果用户没有登录，重定向到 settings.LOGIN_URL，在查询字符串中传递当前的绝对路径。例如： /accounts/login/?next=/polls/3/。

• 如果用户已登录，正常执行视图。视图代码可以自由地假设用户已登录。

默认情况下，用户成功认证后应重定向到的路径存储在名为 "next" 的查询字符串参数中。如果你想要使用不同的参数名称，login_required() 接受一个可选的 redirect_field_name 参数：

Code

from django.contrib.auth.decorators import login_required


@login_required(redirect_field_name="my_redirect_field")
def my_view(request): ...

请注意，如果你为 redirect_field_name 提供了一个值，你很可能还需要自定义你的登录模板，因为存储重定向路径的模板上下文变量将使用 redirect_field_name 的值作为其键，而不是（默认值） "next"。

login_required() 还接受一个可选的 login_url 参数。示例：

Code

from django.contrib.auth.decorators import login_required


@login_required(login_url="/accounts/login/")
def my_view(request): ...

请注意，如果你没有指定``login_url``参数，你需要确保 settings.LOGIN_URL 和你的登录视图正确关联。例如，使用默认值，将以下行添加到你的 URL 配置文件中：

Code

from django.contrib.auth import views as auth_views

path("accounts/login/", auth_views.LoginView.as_view()),

settings.LOGIN_URL 也接受视图函数名称和 命名的 URL 模式。这允许你在 URL 配置中自由重新映射你的登录视图，而无需更新该设置。

LoginRequiredMixin 混合类Link to this heading#

当使用 基于类的视图 时，你可以通过使用 LoginRequiredMixin 来实现与 login_required 相同的行为。这个混合类应该在继承列表的最左边位置。

class LoginRequiredMixinLink to this definition#

如果一个视图使用了这个混合类，所有非经过身份验证的用户的请求将被重定向到登录页面或显示 HTTP 403 禁止访问的错误，这取决于 raise_exception 参数的设置。

你可以设置 AccessMixin 的任何参数来自定义未经授权用户的处理方式：

Code

from django.contrib.auth.mixins import LoginRequiredMixin


class MyView(LoginRequiredMixin, View):
    login_url = "/login/"
    redirect_field_name = "redirect_to"

限制只有经过测试的已登录用户才能访问Link to this heading#

要基于特定权限或其他测试来限制访问，你可以基本上按照前一节所述的方法进行操作。

你可以直接在视图中对 request.user 进行测试。例如，这个视图检查用户是否拥有所需域中的电子邮件，如果没有，就重定向到登录页面：

from django.shortcuts import redirect


def my_view(request):
    if not request.user.email.endswith("@example.com"):
        return redirect("/login/?next=%s" % request.path)
    # ...

user_passes_test(test_func, login_url=None, redirect_field_name='next')Link to this definition#

作为一种快捷方式，你可以使用方便的 user_passes_test 装饰器，当可调用对象返回 False 时，它会执行重定向：

Code

from django.contrib.auth.decorators import user_passes_test


def email_check(user):
    return user.email.endswith("@example.com")


@user_passes_test(email_check)
def my_view(request): ...

user_passes_test() 接受一个必需的参数，即一个可调用对象，该对象接受一个 User 对象，并在用户被允许查看页面时返回 True。请注意，user_passes_test() 不会自动检查 User 是否是匿名用户。

user_passes_test() 接受两个可选参数：

login_url

允许你指定未通过测试的用户将被重定向到的 URL。如果你没有指定一个 URL，它可能是一个登录页面，并且默认为 settings.LOGIN_URL。

redirect_field_name

与 login_required() 类似。将其设置为 None 将其从 URL 中移除，如果你将不通过测试的用户重定向到一个没有 "下一页" 的非登录页面，你可能会想这样做。

例如：

Code

@user_passes_test(email_check, login_url="/login/")
def my_view(request): ...

class UserPassesTestMixinLink to this definition#

当使用 基于类的视图 时，你可以使用 UserPassesTestMixin 来实现这一点。

test_func()Link to this definition#

你需要重写类的 test_func() 方法来提供要执行的测试。此外，你可以设置 AccessMixin 的任何参数来自定义未经授权用户的处理方式：

Code

from django.contrib.auth.mixins import UserPassesTestMixin


class MyView(UserPassesTestMixin, View):
    def test_func(self):
        return self.request.user.email.endswith("@example.com")

get_test_func()Link to this definition#

你还可以重写 get_test_func() 方法，以便混合类使用不同名称的函数进行检查（而不是 test_func()）。

permission_required 装饰器Link to this heading#

permission_required(perm, login_url=None, raise_exception=False)Link to this definition#

检查用户是否具有特定权限是一个相对常见的任务。因此，Django 为这种情况提供了一个快捷方式： permission_required() 装饰器。

Code

from django.contrib.auth.decorators import permission_required


@permission_required("polls.add_choice")
def my_view(request): ...

就像 has_perm() 方法一样，权限名称采用形式 "<app label>.<permission codename>" （例如，在 polls 应用程序中的模型上的权限为 polls.add_choice ）。

该装饰器还可以接受一个权限的可迭代对象，此时用户必须具备所有这些权限才能访问视图。

请注意，permission_required() 还接受一个可选的 login_url 参数：

Code

from django.contrib.auth.decorators import permission_required


@permission_required("polls.add_choice", login_url="/loginpage/")
def my_view(request): ...

与 login_required() 装饰器一样，login_url 默认为 settings.LOGIN_URL。

如果提供了 raise_exception 参数，装饰器将引发 PermissionDenied 异常，而不是重定向到登录页面，从而触发 403（HTTP Forbidden）视图。

如果你想使用 raise_exception，但也想让用户有机会首先登录，你可以添加 login_required() 装饰器：

Code

from django.contrib.auth.decorators import login_required, permission_required


@login_required
@permission_required("polls.add_choice", raise_exception=True)
def my_view(request): ...

这也可以避免在 LoginView 的 redirect_authenticated_user=True 且已登录用户没有所有所需权限时发生重定向循环。

PermissionRequiredMixin MixinLink to this heading#

要将权限检查应用于 基于类的视图，你可以使用 PermissionRequiredMixin：

class PermissionRequiredMixinLink to this definition#

这个混合类，就像 permission_required 装饰器一样，检查访问视图的用户是否具有所有给定的权限。你应该使用 permission_required 参数来指定权限（或权限的可迭代对象）：

Code

from django.contrib.auth.mixins import PermissionRequiredMixin


class MyView(PermissionRequiredMixin, View):
    permission_required = "polls.add_choice"
    # Or multiple of permissions:
    permission_required = ["polls.view_choice", "polls.change_choice"]

你可以设置 AccessMixin 的任何参数来自定义未经授权用户的处理方式。

你可能同样需要重写这些方法：

get_permission_required()Link to this definition#

返回一个被混合类使用的权限名称的可迭代对象。默认为 permission_required 属性，如果需要会将其转换为元组。

has_permission()Link to this definition#

返回一个布尔值，表示当前用户是否具有执行装饰视图的权限。默认情况下，这将返回调用 has_perms() 与 get_permission_required() 返回的权限列表的结果。

密码更改时的会话失效Link to this heading#

如果你的 AUTH_USER_MODEL 继承自 AbstractBaseUser 或实现了自己的 get_session_auth_hash() 方法，已认证的会话将包括该函数返回的哈希值。在 AbstractBaseUser 的情况下，这是密码字段的 HMAC。Django 在每个请求中验证会话中的哈希是否与请求期间计算的哈希匹配。这允许用户通过更改密码来注销他们的所有会话。

Django 默认包含的密码更改视图，包括 PasswordChangeView 和 django.contrib.auth 管理界面中的 user_change_password 视图，会使用新的密码哈希更新会话，以便用户更改自己的密码不会注销自己。如果你有自定义的密码更改视图并希望具有类似的行为，可以使用 update_session_auth_hash() 函数。

update_session_auth_hash(request, user)Link to this definition#

aupdate_session_auth_hash(request, user)Link to this definition#

异步版本：aupdate_session_auth_hash()

这个函数接受当前请求和已更新的用户对象，新的会话哈希将从中派生，并适当地更新会话哈希。它还会轮换会话密钥，以使被盗的会话 cookie 无效。

用法示例：

Code

from django.contrib.auth import update_session_auth_hash


def password_change(request):
    if request.method == "POST":
        form = PasswordChangeForm(user=request.user, data=request.POST)
        if form.is_valid():
            form.save()
            update_session_auth_hash(request, form.user)
    else:
        ...

使用视图Link to this heading#

有多种方法可以在项目中实现这些视图。最简单的方法是在你自己的 URL 配置中包含提供的 URLconf，例如：

urlpatterns = [
    path("accounts/", include("django.contrib.auth.urls")),
]

这将包括以下 URL 模式：

accounts/login/ [name='login']
accounts/logout/ [name='logout']
accounts/password_change/ [name='password_change']
accounts/password_change/done/ [name='password_change_done']
accounts/password_reset/ [name='password_reset']
accounts/password_reset/done/ [name='password_reset_done']
accounts/reset/<uidb64>/<token>/ [name='password_reset_confirm']
accounts/reset/done/ [name='password_reset_complete']

这些视图提供了一个URL名称，以便更容易引用。有关使用命名URL模式的详细信息，请参阅 URL文档。

如果你想要更多控制你的 URL，你可以在你的 URLconf 中引用一个特定的视图：

from django.contrib.auth import views as auth_views

urlpatterns = [
    path("change-password/", auth_views.PasswordChangeView.as_view()),
]

视图有可选参数，你可以使用这些参数来更改视图的行为。例如，如果你想要更改视图使用的模板名称，你可以提供 template_name 参数。一种方法是在 URLconf 中提供关键字参数，这些参数将传递给视图。例如：

urlpatterns = [
    path(
        "change-password/",
        auth_views.PasswordChangeView.as_view(template_name="change-password.html"),
    ),
]

所有视图都是 基于类的，这使你可以通过子类化轻松自定义它们。

所有认证视图Link to this heading#

这是所有由 django.contrib.auth 提供的视图列表。有关实现细节，请参阅 使用视图。

class LoginViewLink to this definition#

URL 名称： login

请参阅 URL 文档 以获取有关使用命名 URL 模式的详细信息。

方法和属性

template_nameLink to this definition#

用于显示用户登录视图的模板名称。默认为 registration/login.html。

next_pageLink to this definition#

登录后重定向的 URL。默认为 LOGIN_REDIRECT_URL。

redirect_field_nameLink to this definition#

包含登录后重定向 URL 的 GET 字段名称。默认为 next。如果传递了给定的 GET 参数，将覆盖 get_default_redirect_url() URL。

authentication_formLink to this definition#

用于身份验证的可调用对象（通常是一个表单类）。默认为 AuthenticationForm。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

redirect_authenticated_userLink to this definition#

一个布尔值，控制是否对已经认证的用户访问登录页面进行重定向，就好像他们刚刚成功登录一样。默认为 False。

success_url_allowed_hostsLink to this definition#

一个主机集合，用于登录后的重定向，除了 request.get_host()，默认为空 set。

get_default_redirect_url()Link to this definition#

返回登录后重定向的URL。如果设置了默认实现会解析并返回 next_page，否则返回 LOGIN_REDIRECT_URL。

以下是 LoginView 所做的事情：

• 如果通过 GET 调用，它会显示一个登录表单，该表单将数据 POST 到相同的 URL。稍后会详细介绍这一点。

• 如果通过用户提交的凭据调用 POST，它会尝试登录用户。如果登录成功，视图将重定向到 next 参数指定的 URL。如果未提供 next，它将重定向到 settings.LOGIN_REDIRECT_URL （默认为 /accounts/profile/ ）。如果登录不成功，它会重新显示登录表单。

你需要提供登录模板的 HTML，默认情况下命名为 registration/login.html。该模板将接收四个模板上下文变量：

• form: 一个代表 AuthenticationForm 的 Form 对象。

• next: 登录成功后要重定向的 URL。这可能包含查询字符串。

• site: 根据 SITE_ID 设置，表示当前的 Site。如果你没有安装站点框架，它将设置为 RequestSite 的实例，该实例从当前的 HttpRequest 获取站点名称和域名。

• site_name: 用于别名 site.name。如果你没有安装站点框架，它将设置为 request.META['SERVER_NAME'] 的值。有关站点的更多信息，请参阅 “站点”框架。

如果你不想将模板命名为 registration/login.html，你可以通过额外的参数将 template_name 参数传递给 URLconf 中的 as_view 方法。例如，以下 URLconf 行将使用 myapp/login.html：

Code

path("accounts/login/", auth_views.LoginView.as_view(template_name="myapp/login.html")),

你还可以使用 redirect_field_name 指定包含登录后重定向 URL 的 GET 字段的名称。默认情况下，该字段称为 next。

以下是一个示例 registration/login.html 模板，你可以将其用作起点。它假定你有一个定义了 content 块的 base.html 模板：

Django template

{% extends "base.html" %}

{% block content %}

{% if form.errors %}
<p>Your username and password didn't match. Please try again.</p>
{% endif %}

{% if next %}
    {% if user.is_authenticated %}
    <p>Your account doesn't have access to this page. To proceed,
    please login with an account that has access.</p>
    {% else %}
    <p>Please login to see this page.</p>
    {% endif %}
{% endif %}

<form method="post" action="{% url 'login' %}">
{% csrf_token %}
<table>
<tr>
    <td>{{ form.username.label_tag }}</td>
    <td>{{ form.username }}</td>
</tr>
<tr>
    <td>{{ form.password.label_tag }}</td>
    <td>{{ form.password }}</td>
</tr>
</table>

<input type="submit" value="login">
<input type="hidden" name="next" value="{{ next }}">
</form>

{# Assumes you set up the password_reset view in your URLconf #}
<p><a href="{% url 'password_reset' %}">Lost password?</a></p>

{% endblock %}

如果你已经自定义了身份验证（参见 自定义身份验证），你可以通过设置 authentication_form 属性来使用自定义的身份验证表单。这个表单必须在其 __init__() 方法中接受一个 request 关键字参数，并提供一个返回经过身份验证的用户对象的 get_user() 方法（此方法仅在表单验证成功后调用）。

class LogoutViewLink to this definition#

在 POST 请求中登出用户。

URL 名称: logout

属性:

next_pageLink to this definition#

登出后重定向的 URL。默认为 LOGOUT_REDIRECT_URL。

template_nameLink to this definition#

在用户注销后显示的模板的全名。默认为 registration/logged_out.html。

redirect_field_nameLink to this definition#

GET 字段的名称，包含在登出后重定向的 URL。默认为 'next'。如果传递了给定的 GET 参数，则会覆盖 next_page URL。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

success_url_allowed_hostsLink to this definition#

一个 set，除了 request.get_host() 外，用于在注销后安全重定向的主机。默认为空的 set。

模板上下文：

• title：本地化的字符串 "已注销"。

• site: 根据 SITE_ID 设置，表示当前的 Site。如果你没有安装站点框架，它将设置为 RequestSite 的实例，该实例从当前的 HttpRequest 获取站点名称和域名。

• site_name: 用于别名 site.name。如果你没有安装站点框架，它将设置为 request.META['SERVER_NAME'] 的值。有关站点的更多信息，请参阅 “站点”框架。

logout_then_login(request, login_url=None)Link to this definition#

在 POST 请求上注销用户，然后重定向到登录页面。

URL 名称： 未提供默认 URL

可选参数：

• login_url: 要重定向到的登录页面的 URL。如果未提供，默认为 settings.LOGIN_URL。

class PasswordChangeViewLink to this definition#

URL 名称： password_change

允许用户更改他们的密码。

属性:

template_nameLink to this definition#

用于显示密码更改表单的模板的完整名称。如果未提供，默认为 registration/password_change_form.html。

success_urlLink to this definition#

在成功更改密码后重定向到的 URL。默认为 'password_change_done'。

form_classLink to this definition#

一个自定义的“更改密码”表单，必须接受一个 user 关键字参数。该表单负责实际更改用户的密码。默认为 PasswordChangeForm。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

模板上下文：

• form：密码更改表单（参见上面的 form_class）。

class PasswordChangeDoneViewLink to this definition#

URL 名称： password_change_done

用户成功更改密码后显示的页面。

属性:

template_nameLink to this definition#

要使用的模板的完整名称。如果未提供，默认为 registration/password_change_done.html。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

class PasswordResetViewLink to this definition#

URL 名称： password_reset

允许用户通过生成一次性使用的链接来重置密码，并将该链接发送到用户注册的电子邮件地址。

如果满足以下条件，此视图将发送电子邮件：

• 提供的电子邮件地址存在于系统中。

• 所请求的用户处于活动状态（ User.is_active 为 True ）。

• 所请求的用户具有可用的密码。被标记为不可用密码的用户（参见 set_unusable_password() ）不允许请求密码重置，以防止在使用外部身份验证源如 LDAP 时被滥用。

如果不满足上述任何条件，将不会发送电子邮件，但用户也不会收到任何错误消息。这可以防止信息泄漏给潜在的攻击者。如果您想在这种情况下提供错误消息，可以子类化 PasswordResetForm 并使用 form_class 属性。

属性:

template_nameLink to this definition#

要用于显示密码重置表单的模板的完整名称。如果未提供，默认为 registration/password_reset_form.html。

form_classLink to this definition#

将用于获取要重置密码的用户电子邮件的表单。默认为 PasswordResetForm。

email_template_nameLink to this definition#

要用于生成带有重置密码链接的电子邮件的模板的完整名称。如果未提供，默认为 registration/password_reset_email.html。

subject_template_nameLink to this definition#

要用于电子邮件主题的模板的完整名称，其中包含重置密码链接。如果未提供，默认为 registration/password_reset_subject.txt。

token_generatorLink to this definition#

用于检查一次性链接的类的实例。默认为 default_token_generator，它是 django.contrib.auth.tokens.PasswordResetTokenGenerator 的实例。

success_urlLink to this definition#

在成功重置密码请求后重定向到的 URL。默认为 'password_reset_done'。

from_emailLink to this definition#

有效的电子邮件地址。默认情况下，Django 使用 DEFAULT_FROM_EMAIL。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

html_email_template_nameLink to this definition#

用于生成带有密码重置链接的 text/html 多部分电子邮件的模板的完整名称。默认情况下，不会发送 HTML 电子邮件。

extra_email_contextLink to this definition#

一个包含在电子邮件模板中可用的上下文数据的字典。它可以用于覆盖下面列出的默认模板上下文值，例如 domain。

模板上下文：

• form：用于重置用户密码的表单（参见上面的 form_class）。

电子邮件模板上下文：

• email ： user.email 的别名

• user ：根据 email 表单字段，表示当前的 User。只有活动用户才能重置他们的密码（ User.is_active is True ）。

• site_name: 用于别名 site.name。如果你没有安装站点框架，它将设置为 request.META['SERVER_NAME'] 的值。有关站点的更多信息，请参阅 “站点”框架。

• domain ：site.domain 的别名。如果你没有安装站点框架，这将设置为 request.get_host() 的值。

• protocol ：http 或 https

• uid ：使用 base 64 编码过的用户主键。

• token ：检测重置密码链接是否有效的 Token 。

示例 registration/password_reset_email.html （电子邮件正文模板）：

Django template

Someone asked for password reset for email {{ email }}. Follow the link below:
{{ protocol}}://{{ domain }}{% url 'password_reset_confirm' uidb64=uid token=token %}

相同的模板上下文用于主题模板。主题必须是单行纯文本字符串。

class PasswordResetDoneViewLink to this definition#

URL 名称： password_reset_done

在向用户发送了重置密码链接后显示的页面。如果 PasswordResetView 没有显式设置 success_url URL，则默认调用此视图。

属性:

template_nameLink to this definition#

要使用的模板的完整名称。如果未提供，默认为 registration/password_reset_done.html。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

class PasswordResetConfirmViewLink to this definition#

URL 名称： password_reset_confirm

提供一个用于输入新密码的表单。

来自 URL 的关键字参数：

• uidb64 ：以 base 64 编码的用户 id。

• token ：检查密码是否有效的 Token。

属性:

template_nameLink to this definition#

用于显示确认密码视图的模板的完整名称。默认值为 registration/password_reset_confirm.html。

token_generatorLink to this definition#

用于检查密码的类的实例。默认为 default_token_generator，它是 django.contrib.auth.tokens.PasswordResetTokenGenerator 的实例。

post_reset_loginLink to this definition#

一个布尔值，指示在成功重置密码后是否应自动对用户进行身份验证。默认为 False。

post_reset_login_backendLink to this definition#

如果 post_reset_login 为 True，在对用户进行身份验证时要使用的身份验证后端的点路径。只有在配置了多个 AUTHENTICATION_BACKENDS 时才需要。默认为 None。

form_classLink to this definition#

将用于设置密码的表单。默认为 SetPasswordForm。

success_urlLink to this definition#

密码重置完成后重定向的 URL。默认为 'password_reset_complete'。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

reset_url_tokenLink to this definition#

作为密码重置 URL 的一部分显示的令牌参数。默认为 'set-password'。

模板上下文：

• form：用于设置新用户密码的表单（参见上面的 form_class）。

• validlink：布尔值，如果链接（uidb64 和 token 的组合）有效或尚未使用，则为 True。

class PasswordResetCompleteViewLink to this definition#

URL 名称： password_reset_complete

提供一个视图，通知用户密码已成功更改。

属性:

template_nameLink to this definition#

用于显示视图的模板的完整名称。默认为 registration/password_reset_complete.html。

extra_contextLink to this definition#

一个包含将添加到传递给模板的默认上下文数据的字典。

用户Link to this heading#

在渲染模板时， RequestContext 会将当前已登录的用户，可以是 User 实例或 AnonymousUser 实例，存储在模板变量 {{ user }} 中：

{% if user.is_authenticated %}
    <p>Welcome, {{ user.username }}. Thanks for logging in.</p>
{% else %}
    <p>Welcome, new user. Please log in.</p>
{% endif %}

如果未使用 RequestContext，则此模板上下文变量将不可用。

权限Link to this heading#

当前已登录用户的权限存储在模板变量 {{ perms }} 中。这是 django.contrib.auth.context_processors.PermWrapper 的一个实例，它是权限的模板友好代理。

将 {{ perms }} 的单属性查找评估为布尔值是 User.has_module_perms() 的代理。例如，要检查已登录用户是否在 foo 应用程序中有任何权限：

{% if perms.foo %}

将双层属性查找评估为布尔值是 User.has_perm() 的代理。例如，要检查已登录用户是否具有权限 foo.add_vote：

{% if perms.foo.add_vote %}

以下是在模板中检查权限的更完整的示例：

{% if perms.foo %}
    <p>You have permission to do something in the foo app.</p>
    {% if perms.foo.add_vote %}
        <p>You can vote!</p>
    {% endif %}
    {% if perms.foo.add_driving %}
        <p>You can drive!</p>
    {% endif %}
{% else %}
    <p>You don't have permission to do anything in the foo app.</p>
{% endif %}

也可以使用 {% if in %} 语句查找权限。例如：

{% if 'foo' in perms %}
    {% if 'foo.add_vote' in perms %}
        <p>In lookup works, too.</p>
    {% endif %}
{% endif %}