Skip to content

Latest commit

 

History

History
50 lines (37 loc) · 2.24 KB

2181-user-deactivated-errcode.md

File metadata and controls

50 lines (37 loc) · 2.24 KB

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.