Server Commands/ACCOUNT
m |
|||
| Line 1: | Line 1: | ||
| - | '''Syntax:''' <code>ACCOUNT <numeric> <flag> <account|fd cookie> [timestamp | + | '''Syntax:''' <code>ACCOUNT <target numeric> <type flag> <account|fd cookie> [<timestamp> <serial>]</code> |
| + | Valid types are as follows: | ||
| + | |||
| + | * '''R''' - Register | ||
| + | * '''A''' - LOC authorization | ||
| + | * '''D''' - LOC denied | ||
| + | * '''U''' - Unregister | ||
| + | * '''M''' - Rename | ||
Examples: | Examples: | ||
| - | <pre> | + | <pre> |
| - | + | Numeric Type Account|FD Cookie Timestamp Serial | |
| - | 3* Az AC AB | + | ------------------------------------------------------------------------------ |
| - | 4* Az AC AB | + | 1* Az AC ABAAC R JoeUser 1037526164 4056 -- Register |
| - | 5* Az AC ABAAC U | + | 3* Az AC AB A .15.1835576208 1037526164 4056 -- LOC authorized |
| - | 6* Az AC ABAAC M J0eUser | + | 4* Az AC AB D .15.1835576208 1037526164 -- LOC denied |
| + | 5* Az AC ABAAC U -- Unregister | ||
| + | 6* Az AC ABAAC M J0eUser -- Rename</pre> | ||
| - | The ACCOUNT command implements a login system for ircd-darenet. When received by the user's server, the user (specified by <target> - the user's | + | The <code>ACCOUNT</code> command implements a login system for ircd-darenet. When received by the user's server, the user (specified by <target> - the user's numnick) is considered logged in to the <account>. The <timestamp> parameter specifies a timestamp that can be used to determine which version of the user's account the user is logged in to; this can be used by service bots as a way of distinguishing hacked accounts from legitimate user logins. |
| - | + | The <serial> parameter may be an arbitrary value. On DareNET, it is used to pass the unique id for the account, and optionally a unique identifier for the database used. | |
| - | A user remains logged in until one of the following conditions apply: | + | Unlike ircu, ircd-darenet allows for users to be logged out of an account without the killing the user's IRC session. NOTE: users cannot log themselves out. A user remains logged in until one of the following conditions apply: |
* The account is unregistered through NickServ. | * The account is unregistered through NickServ. | ||
| Line 21: | Line 30: | ||
* The user disconnects. | * The user disconnects. | ||
| - | Since ircd-darenet propogates the account name | + | Since ircd-darenet propogates the account name and timestamp when re-introducting users during net junctions, services bots will be able to see that a user is logged in and set their appropriate internal state. This means that users will stay logged in regardless of netsplits and nickname changes. |
The account is only used by ircd-darenet for pre-logging in users while they're connecting (e.g. login-on-connect), for umode +R & cmodes +R/M, host hiding and for application of channel bans and silence masks. ircd-darenet does not otherwise use account information. | The account is only used by ircd-darenet for pre-logging in users while they're connecting (e.g. login-on-connect), for umode +R & cmodes +R/M, host hiding and for application of channel bans and silence masks. ircd-darenet does not otherwise use account information. | ||
Revision as of 00:12, 16 June 2011
Syntax: ACCOUNT <target numeric> <type flag> <account|fd cookie> [<timestamp> <serial>]
Valid types are as follows:
- R - Register
- A - LOC authorization
- D - LOC denied
- U - Unregister
- M - Rename
Examples:
Numeric Type Account|FD Cookie Timestamp Serial
------------------------------------------------------------------------------
1* Az AC ABAAC R JoeUser 1037526164 4056 -- Register
3* Az AC AB A .15.1835576208 1037526164 4056 -- LOC authorized
4* Az AC AB D .15.1835576208 1037526164 -- LOC denied
5* Az AC ABAAC U -- Unregister
6* Az AC ABAAC M J0eUser -- Rename
The ACCOUNT command implements a login system for ircd-darenet. When received by the user's server, the user (specified by <target> - the user's numnick) is considered logged in to the <account>. The <timestamp> parameter specifies a timestamp that can be used to determine which version of the user's account the user is logged in to; this can be used by service bots as a way of distinguishing hacked accounts from legitimate user logins.
The <serial> parameter may be an arbitrary value. On DareNET, it is used to pass the unique id for the account, and optionally a unique identifier for the database used.
Unlike ircu, ircd-darenet allows for users to be logged out of an account without the killing the user's IRC session. NOTE: users cannot log themselves out. A user remains logged in until one of the following conditions apply:
- The account is unregistered through NickServ.
- The account is suspended through NickServ.
- The user disconnects.
Since ircd-darenet propogates the account name and timestamp when re-introducting users during net junctions, services bots will be able to see that a user is logged in and set their appropriate internal state. This means that users will stay logged in regardless of netsplits and nickname changes.
The account is only used by ircd-darenet for pre-logging in users while they're connecting (e.g. login-on-connect), for umode +R & cmodes +R/M, host hiding and for application of channel bans and silence masks. ircd-darenet does not otherwise use account information.
ACCOUNT is intended to be issued by service bots on the network. The login-on-connect system is based on IAuth, which causes the server to introduce the client as logged in, just as during net junctions.
