rest_auth.serializers

Serializer implementations for authentication.

class rest_auth.serializers.LoginSerializer(instance=None, data=<class 'rest_framework.fields.empty'>, **kwargs)

Serializer for loggin in. It checks username and password are correct for settings.AUTH_USER_MODEL.

After validating it, user instance created for authenticated user. View methods should persist this user. (through django.contrib.auth.login)

Parameters:

• username – USERNAME_FIELD for AUTH_USER_MODEL
• password – user’s password

validate(data)

Checks username & password. uses django.contrib.auth.authenticate

Parameters:data – validated data from Serializer.validate Returns:validated_data Raises:VaildationError – if username or password are incorrect

confirm_login_allowed(user)

Checks if validated user is allowed for website.

Override this method if you use custom authentication method and have additional methods for allowing login.

Raises:VaildationError – if user are not allowed

create(validated_data)

persist a authenticated user in this step.

Parameters:validated_data – validated_data should contains request. You should pass request to serialzer.save.

perform_login(request, user)

Persist a user. Override this method if you do more than persisting user.

get_user()

Returns:user instance created after self.validate

class rest_auth.serializers.PasswordResetSerializer(instance=None, data=<class 'rest_framework.fields.empty'>, **kwargs)

Sends a website link for resetting password. It uses django’s PasswordResetForm directly because there is just one required field, email, and form implemented its business logic nicely.

Parameters:email – email address to receive password-reset-link.

password_reset_form_class

alias of django.contrib.auth.forms.PasswordResetForm

validate_email(value)

Raises:

• VaildationError – rest_framework’s field validation
• VaildationError – django’s field vaildation

save(domain_override=None, subject_template_name='registration/password_reset_subject.txt', email_template_name='registration/password_reset_email.html', use_https=True, token_generator=<django.contrib.auth.tokens.PasswordResetTokenGenerator object>, from_email=None, request=None, html_email_template_name=None, extra_email_context=None)

sends a email, which contains link for resetting password

class rest_auth.serializers.SetPasswordSerializer(user, *args, **kwargs)

This serializer resets password of a given user. Please be VERY CAREFUL for using this any given user’s password can be changed.

Setting permission IsAdminUser is recommended.

Parameters:

• new_password1 – new password
• new_password2 – new password confirmation.

validate(data)

Raises:VaildationError – if two given passwords are different.

create(validated_data)

resets password

class rest_auth.serializers.PasswordChangeSerializer(user, *args, **kwargs)

resets password of user. Resetting password is done if old_password is correct and two new passwords are equals.

Parameters:

• old_password – old_password
• new_password1 – new password
• new_password2 – new password confirmation.

validate_old_password(old_password)

Raises:ValidationError – if old_password is not correct