使用django的认证系统
User 对象
User是认证系统的核心。典型代表是用户和你的站点进行交互还有限制访问、注册用户等等。django认证框架中，只存在一个User类，像'superuser'和'staff'等等都是User的对象，只是某些属性不一样而已。
class User(AbstractUser):
"""
Users within the Django authentication system are represented by this
model. Username, password and email are required. Other fields are optional.
"""
class Meta(AbstractUser.Meta):
swappable = 'AUTH_USER_MODEL'
User继承自一个抽象基类，提供了User模块所有的功能
class AbstractUser(AbstractBaseUser, PermissionsMixin):
"""
An abstract base class implementing a fully featured User model with
admin-compliant permissions. Username and password are required. Other fields are optional.
"""
username = models.CharField(
_('username'),
max_length=30,
unique=True,
help_text=_('Required. 30 characters or fewer. Letters, digits and @/./+/-/_ only.'),
validators=[
validators.RegexValidator(
r'^[\w.@+-]+$',
_('Enter a valid username. This value may contain only '
'letters, numbers ' 'and @/./+/-/_ characters.')
),
],
error_messages={
'unique': _("A user with that username already exists."),
},
)
first_name = models.CharField(_('first name'), max_length=30, blank=True)
last_name = models.CharField(_('last name'), max_length=30, blank=True)
email = models.EmailField(_('email address'), blank=True)
is_staff = models.BooleanField(
_('staff status'),
default=False,
help_text=_('Designates whether the user can log into this admin site.'),
)
is_active = models.BooleanField(
_('active'),
default=True,
help_text=_(
'Designates whether this user should be treated as active. '
'Unselect this instead of deleting accounts.'
),
)
date_joined = models.DateTimeField(_('date joined'), default=timezone.now) objects = UserManager() USERNAME_FIELD = 'username'
REQUIRED_FIELDS = ['email'] class Meta:
verbose_name = _('user')
verbose_name_plural = _('users')
abstract = True def get_full_name(self):
"""
Returns the first_name plus the last_name, with a space in between.
"""
full_name = '%s %s' % (self.first_name, self.last_name)
return full_name.strip() def get_short_name(self):
"Returns the short name for the user."
return self.first_name def email_user(self, subject, message, from_email=None, **kwargs):
"""
Sends an email to this User.
"""
send_mail(subject, message, from_email, [self.email], **kwargs)
API
默认的用户类字段有如下：
username 最多三十个字符
first_name
last_name
password
group
user_permissions
is_staff 布尔值，用户能否访问管理后台页面
is_active 布尔值。它的作用并不是用来决定某用户是否有权限访问网站，而是用在其他地方：如匿名用户默认就被设置为了 is_active = False
is_superuser 布尔值 是否是超级用户
last_login 最后一次登录时间（1.8+如果用户从来没有登陆过，那么该字段将被置为null之前都是置为当前时间）
date_joined 用户创建时间
方法：
get_username() 使用这个方法返回用户名，而不是直接引用User的username属性
is_anonymous() 总是返回False 是否是匿名用户
is_authenticated() 总是返回True 用户是否经过验证。不代表任何权限也不检查用户是否活跃或者是是否拥有一个回话。 当你检测该用户是否已经登录时可以使用该方法
get_full_name() 获得全名 first_name last_name
get_short_name() 返回first_name
set_password(raw_passwrod) 设置用户密码，不保存User 对象。当raw_password为空时，它做的和set_unusable_password()一样
set_unusable_password() 标记用户没有设置密码，这和设置了一个空字符密码的情形不一样，check_password()在检查这个用户是将永远不会返回True。你用其他的认证源的时候，可以使用这个方法。
check_password(raw_password) 检查密码，如果密码正确返回True
has_usable_password() 如果set_unusable_password()被调用之后，该方法返回False
get_group_permissions(obj=None) 返回用户所在组所拥有的权限。如果传入了参数，那么只返回该组的权限。一个字符串组成的集合。
get_all_permissions(obj=Noe) 返回用户所有的权限，包括自己本身的权限和所在组的权限。如果传入特定参数，那么只返回该组的权限。一个字符串集合
has_perms(perm,obj=None) 如果用户有指定权限，那么就返回True。如果用户被设置为了inactive，那么该方法永远返回False。默认是检查用户对某个model
的权限，如果传入和指定的obj那么只检查用户对该obj是否有权限。
has_module_perms(package_name) 只要用户对某APP有任何的权限，那么返回True。同样，如果用户被设置了inactive，那么永远返回False
email_user(subject,message,from_email=None,**kwargs) 发送邮件。from_email如果没有指定那么django使用DEFAULT_FROM_EMAIL指定的用户
Manger（每个model一个默认的manager，默认名为：objects）
方法：
create_user(username,email=None,password=None,**extra_fields)
创建、保存并返回一个User对象
from django.contrib.auth.models import User
>>> user = User.objects.create_user('john', 'lennon@thebeatles.com', 'johnpassword')
如果配置了用户名和密码，那么该用户的is_active=True，如果没有设置password那么将会调用set_unusable_password，用户将被置为is_active=False(猜测，待验证）
**extra_fields 用于自定义User模型。是User的__init__参数
create_superuser(username,email,password,**extra_fields) 创建超级用户
python manage.py changepassword username
#更改指定用户密码，如果未指定用户，更改当前系统用户的密码，注意：该系统用户名可能不存在在该project中。例如：如果不提供用户名，会修改我电脑用户名的账户密码，提示错如：CommendError:user 'an' does not exist
>>> from django.contrib.auth.models import User
>>> u = User.objects.get(username='john')
>>> u.set_password('new password')
>>> u.save()
如果启用了SessionAuthenticationMiddleware，那么更改密码，会退出该用户的所有用户回话。
authenticate()
验证用户名和密码，如果成功返回一个 User 对象，否则返回 None
User对象有两个ManyToManyField,分别是：groups和user_permissions
myuser.groups = [group_list]
myuser.groups.add(group, group, ...)
myuser.groups.remove(group, group, ...)
myuser.groups.clear()
myuser.user_permissions = [permission_list]
myuser.user_permissions.add(permission, permission, ...)
myuser.user_permissions.remove(permission, permission, ...)
myuser.user_permissions.clear()
AnonymouseUser匿名用户
django.contrib.auth.models.AnonymouseUser
id 总是None
username 总是 空字符串
get_username 总是返回空字符串
is_staff 和is_superuser 总是返回False
is_active 总是返回False
groups和user_permissions总是空的
is_anonymous() 返回True （User返回False）
is_authenticated()返回False (User返回Ture)
set_password(),check_password,save(),delete()引发NotImplementedError.错误