User 对象具有如下字段：
必选。少于等于30个字符。 用户名可以包含字母、数字、_、@、+、.和- 字符。
可选。 少于等于30个字符。
可选。少于30个字符。
可选。邮箱地址。
与Permission 之间的多对多关系。
布尔值。指示用户是否可以访问Admin 站点。
布尔值。指示用户的账号是否激活。我们建议把这个标记设置为False 来代替删除账号；这样的话，如果你的应用和User 之间有外键关联，外键就不会失效。
它不是用来控制用户是否能够登录。认证的后端没有要求检查is_active 标记，而且默认的后端不会检查。如果你想在is_active 为False 时拒绝用户登录，你需要在你自己的视图或自定义的认证后端中作检查。但是，默认的login() 视图使用的AuthenticationForm 却会 作这个检查，正如在Django 的Admin 站点中所做的权限检查方法如has_perm() 和认证一样。对于未激活的用户，所有这些函数/方法都返回False。
布尔值。指定这个用户拥有所有的权限而不需要给他们分配明确的权限。
用户最后一次登录的时间。
如果这个用户没有登录过，这个字段将会是null。以前默认设置成当前的date/time。
账户创建的时间。当账号创建时，默认设置为当前的date/time。
返回这个User 的username。因为User 模型可以置换，你应该使用这个方法而不要直接访问username 属性。
永远返回False。这是区别User 和AnonymousUser 对象的一种方法。一般情况下，相比这个方法更建议你使用is_authenticated()。
永远返回True（与AnonymousUser.is_authenticated() 永远返回False 相反）。这是区分用户是否已经认证的一种方法。它不检查权限、用户是否激活以及是否具有一个合法的会话。即使通常你将在request.user上面 调用这个方法来确认用户是否已经被AuthenticationMiddleware 填充（表示当前登录的用户），你应该明白这个方法对于任何User 实例都返回True。
返回first_name 和last_name，之间带有一个空格。
返回first_name。
设置用户的密码为给定的原始字符串，并负责密码的哈希。不会保存User 对象。
当raw_password 为None 时，密码将设置为一个不可用的密码，和使用set_unusable_password() 的效果一样。
Returns True if the given raw string is the correct password for the user.（它负责在比较时密码的哈希）。
标记用户为没有设置密码。它与密码为空的字符串不一样。check_password() 对这种用户永远不会返回True。不会保存User 对象。
如果你的认证发生在外部例如LDAP 目录时，可能需要这个函数。
如果对这个用户调用过set_unusable_password()，则返回False。
返回一个用户当前拥有的权限的set，通过用户组
如果传入obj，则仅返回此特定对象的组权限。http://python.usyiyi.cn/translate/django_182/ref/contrib/auth.html#
通过组和用户权限返回用户拥有的一组权限字符串。
如果传入obj，则仅返回此特定对象的权限。
如果用户具有指定的权限，则返回True，其中perm的格式为“＆lt； app label＆gt；。＆lt； permission codename＆gt；“。（请参阅有关permissions）。如果用户处于非活动状态，此方法将始终返回False。
如果传入obj，此方法将不会检查模型的权限，而是检查此特定对象。
如果用户具有每个指定的权限，则返回True，其中每个perm的格式为“＆lt； app label＆gt；。＆lt； permission codename＆gt；“。如果用户处于非活动状态，此方法将始终返回False。
如果传入obj，此方法将不会检查模型的权限，而是检查特定对象。
如果用户具有给出的package（Django 的应用标签）中的权限，则返回True。如果用户没有激活，这个方法将永远返回 False。
发生邮件给这个用户。如果from_email 为None，Django 将使用DEFAULT_FROM_EMAIL。
任何**kwargs 都将传递给底层的send_mail() 调用。
User 模型有一个自定义的管理器，它具有以下辅助方法（除了BaseUserManager 提供的方法之外）：
创建、保存并返回一个User。
username 和password 设置为给出的值。email 的域名部分将自动转换成小写，返回的User 对象将设置is_active 为True。
如果没有提供password，将调用 set_unusable_password()。
extra_fields 关键字参数将传递给User 的__init__ 方法，以允许设置自定义User 模型 的字段。
参见创建用户 中的示例用法。
与create_user() 相同，但是设置is_staff 和is_superuser 为True。
django.contrib.auth.models.AnonymousUser 类实现了django.contrib.auth.models.User 接口，但具有下面几个不同点：
新增AnonymousUser.get_username() 以更好地模拟 django.contrib.auth.models.User。
在实际应用中，你自己可能不需要使用AnonymousUser 对象，它们用于Web 请求，在下节会讲述。
Group 对象有以下字段:
必填项，80个字符以内。允许任何字符. 例如: 'Awesome Users'.
多对多字段到Permission：
group.permissions = [permission_list]
group.permissions.add(permission, permission, ...)
group.permissions.remove(permission, permission, ...)
group.permissions.clear()
auth框架使用以下signals，可用于在用户登录或注销时通知。
当用户成功登录时发送。
与此信号一起发送的参数：
在调用logout方法时发送。
当用户登录失败时发送
这一节详细讲述Django 自带的认证后台。关于如何使用它们以及如何编写你自己的认证后台，参见用户认证指南 中的其它认证源一节。
以下是django.contrib.auth.backends 中可以使用的后台：
这是Django使用的默认认证后台。它使用由用户标识和密码组成的凭据进行认证。对于Django的默认用户模型，用户的标识是用户名，对于自定义的用户模型，它通过USERNAME_FIELD 字段表示（参见自定义Users 和认证）。
它还处理 User 和PermissionsMixin 定义的权限模型。
has_perm(), get_all_permissions(), get_user_permissions(), 和get_group_permissions() 允许一个对象作为特定权限参数来传递, 如果条件是 if obj is not None. 后端除了返回一个空的permissions 外，并不会去完成他们。
通过调用User.check_password 验证username 和password。如果username 没有提供，它会使用CustomUser.USERNAME_FIELD 关键字从kwargs 中获取username。返回一个认证过的User 或None。
返回user_obj具有的自己用户权限的权限字符串集合。如果is_anonymous()或is_active为False，则返回空集。
返回user_obj从其所属组的权限中获取的权限字符集。如果is_anonymous()或is_active为False，则返回空集。
返回user_obj的权限字符串集，包括用户权限和组权限。如果is_anonymous()或is_active为False，则返回空集。
使用get_all_permissions()检查user_obj是否具有权限字符串perm。如果用户不是is_active，则返回False。
使用这个后台来处理Django的外部认证。. 它使用 request.里面的usernames来进行验证。META ['REMOTE_USER']。请参阅Authenticating against REMOTE_USER文档。
如果你需要更多的控制，你可以创建你自己的验证后端，继承这个类，并重写这些属性或方法：
作为remote_user传递的用户名被认为是可信的。此方法仅返回给定用户名的User对象，如果create_unknown_user为True，则创建新的User对象。
如果create_unknown_user是False，并且在数据库中找不到具有给定用户名的User对象，则返回None。
2015年5月13日