Skip to content

Commit eeb8e83

Browse files
committed
[register] Add UNACCEPTABLE_PASSWORD response + encoding considerations.
1 parent cb97910 commit eeb8e83

File tree

1 file changed

+23
-2
lines changed

1 file changed

+23
-2
lines changed

extensions/register.md

Lines changed: 23 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -92,13 +92,17 @@ Sent by the server is the client is already authenticated.
9292

9393
Sent by the server if the password is considered too weak.
9494

95+
The client MAY try registering again.
96+
97+
FAIL REGISTER UNACCEPTABLE_PASSWORD <account> <message>
98+
99+
Sent by the server if the password is invalid for any reason other than weakness.
100+
95101
The client MAY try registering again.
96102

97103
FAIL REGISTER INVALID_EMAIL <account> <message>
98104

99105
Sent by the server if it cannot send emails to the provided address.
100-
Server implementations should be careful not to accidentally send this as a response
101-
to a valid address.
102106

103107
FAIL REGISTER UNACCEPTABLE_EMAIL <account> <message>
104108

@@ -121,6 +125,23 @@ Sent by the server if the `<code>` in the `VERIFY` command is invalid or expired
121125
Sent by the server if the `REGISTER`/`VERIFY` commands are temporarily unavailable.
122126

123127

128+
# Client considerations
129+
130+
This section is non-normative.
131+
132+
Passwords are opaque byte strings.
133+
It is recommended for them to be valid UTF-8 with no null character;
134+
otherwise authentication may be impossible later (eg. SASL PLAIN is impossible).
135+
Servers may also choose to reject any non-UTF-8 password with `UNACCEPTABLE_PASSWORD`.
136+
137+
138+
# Server considerations
139+
140+
This section is non-normative.
141+
142+
Server implementations should be careful not to accidentally send `INVALID_EMAIL`
143+
as a response to a valid address.
144+
124145

125146

126147
[multiline]: https://github.com/ircv3/ircv3-specifications/pull/398/

0 commit comments

Comments
 (0)