Skip to content

Commit 1142a05

Browse files
committed
account-registration: add the informational account-required cap
Alternative to ircv3#490. Closes: ircv3/ircv3-ideas#73
1 parent fda4587 commit 1142a05

File tree

1 file changed

+13
-1
lines changed

1 file changed

+13
-1
lines changed

extensions/account-registration.md

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -46,7 +46,7 @@ consensus.
4646

4747
This specification uses [standard replies][] framework.
4848

49-
### Capability
49+
### Capabilities
5050

5151
This specification adds the `draft/account-registration` capability, whose
5252
presence signifies that the server accepts the `REGISTER` command.
@@ -71,6 +71,18 @@ The only defined capability keys so far are:
7171
* `custom-account-name` - if present, the account name can be different
7272
from the user's current nickname
7373

74+
This specification also defines the informational `draft/account-required`
75+
capability. If present, it indicates that the connection to the server cannot
76+
be completed unless the clients authenticates, typically via SASL. Note, the
77+
absence of this capability does not indicate that connection registration can
78+
be completed without authentication; it may be disallowed due to specific
79+
properties of the connection (e.g. an untrustworthy IP address), which will be
80+
indicated instead by `FAIL * ACCOUNT_REQUIRED`. If the capability value
81+
`draft/account-registration=before-connect` is advertised, clients should
82+
respond to both of these conditions by suggesting that the user register an
83+
account. Clients MUST NOT request to enable `draft/account-required`, servers
84+
MUST reject any `CAP REQ` command including this capability.
85+
7486
### Commands
7587

7688
REGISTER <account> {<email> | "*"} <password>

0 commit comments

Comments
 (0)