1
0
mirror of https://github.com/django/django.git synced 2024-12-22 17:16:24 +00:00

Doc'd that unusable passwords are defined by metadata in the password field.

This commit is contained in:
David D Lowe 2024-10-23 18:20:36 +01:00 committed by GitHub
parent 4d11ea1ef0
commit de2bb73904
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194

View File

@ -54,7 +54,8 @@ Fields
Required. A hash of, and metadata about, the password. (Django doesn't
store the raw password.) Raw passwords can be arbitrarily long and can
contain any character. See the :doc:`password documentation
contain any character. The metadata in this field may mark the password
as unusable. See the :doc:`password documentation
</topics/auth/passwords>`.
.. attribute:: groups
@ -175,8 +176,9 @@ Methods
.. method:: set_unusable_password()
Marks the user as having no password set. This isn't the same as
having a blank string for a password.
Marks the user as having no password set by updating the metadata in
the :attr:`~django.contrib.auth.models.User.password` field. This isn't
the same as having a blank string for a password.
:meth:`~django.contrib.auth.models.User.check_password()` for this user
will never return ``True``. Doesn't save the
:class:`~django.contrib.auth.models.User` object.