2.2 KiB
Add an Error Code for Signaling a Deactivated User
Currently, when a user attempts to log in, they will receive an M_FORBIDDEN
error code if their password is incorrect. However, if the user's account is
deactivated, they will also receive an M_FORBIDDEN, leaving clients in a
state where they are unable to inform the user that the reason they cannot
log in is that their account has been deactivated. This leads to confusion
and password resetting which ultimately results in frustration.
Proposal
This proposal asks to create a new error code, M_USER_DEACTIVATED, that may
be returned whenever an action is attempted that requires an activited user,
but the authenticating user is deactivated. The HTTP code to return alongside
is 403.
An example of this could be returning M_USER_DEACTIVATED on /login, when
an identifier of a deactivated user is sent to the homeserver. Whether the
password has to be correct depends on whether the Homeserver implementation
removes login information on deactivation. This is an implementation detail.
It should be noted that this proposal is not requiring implementations to
return M_USER_DEACTIVATED on any endpoints when a request from a
deactivated user appears. Instead it is simply defining the new error code,
recommends that it should be used in situations as described above, and that
the client should understand the meaning of it when it is received.
Tradeoffs
The alternative is to continue returning an M_FORBIDDEN, but send back a
different error message. This is undesirable as clients are supposed to treat
the message as an opaque string, and should not be performing any
pattern-matching on it.
Potential issues
None
Security considerations
While the existence of a user was already public knowledge (one can check if the User ID is available through /_matrix/client/r0/register/available, this proposal would allow any user to be able to detect if a registered account has been deactivated, depending on the homeserver's implementation.
Conclusion
Adding M_USER_DEACTIVATED would better inform clients about the state of a
user's account, and lead to less confusion when they cannot log in.